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-адрес |
429 | Too Many Requests | Превышен лимит запросов |
500 | Internal Server Error | Внутренняя ошибка сервера |