5. DELETE /user/emails — удалить email-адреса
Описание
Удаляет один или несколько email-адресов из аккаунта авторизованного пользователя.
Удаление основного email-адреса невозможно, если в аккаунте не останется хотя бы одного подтвержденного адреса.
⚠️ Требуется действительный токен авторизации с правами на управление профилем.
Параметры URL
Данный метод не содержит параметров пути.
Параметры запроса
Данный метод не принимает параметров в строке запроса.
Тело запроса
Тело запроса обязательно и должно быть в формате JSON.
| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
emails | array | Да | Список email-адресов для удаления |
💡 Максимальное количество адресов за один запрос — 10.
Пример запроса
curl -X DELETE "https://api.gitverse.ru/user/emails" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1" \
-d '{
"emails": [
"alice.backup@example.com"
]
}'Ответ (204 No Content)
HTTP/1.1 204 No Content💡 Тело ответа отсутствует. Код
204означает, что указанные email-адреса успешно удалены.
Коды ответа
| Код | Статус | Описание |
|---|---|---|
| 204 | No Content | Email-адреса успешно удалены |
| 400 | Bad Request | Некорректный формат тела запроса |
| 401 | Unauthorized | Токен отсутствует или недействителен |
| 403 | Forbidden | Доступ запрещен |
| 404 | Not Found | Один или несколько email-адресов не найдены в аккаунте |
| 422 | Unprocessable Entity | Попытка удалить единственный подтвержденный email-адрес |
| 500 | Internal Server Error | Внутренняя ошибка сервера |