4. POST /user/emails — добавить новые email-адреса
Описание
Добавляет один или несколько новых email-адресов к аккаунту авторизованного пользователя.
Каждый добавленный адрес требует подтверждения через email (если включена верификация).
⚠️ Требуется действительный токен авторизации с правами на управление профилем.
Параметры URL
Данный метод не содержит параметров пути.
Параметры запроса
Данный метод не принимает параметров в строке запроса.
Тело запроса
Тело запроса обязательно и должно быть в формате JSON.
| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
emails | array | Да | Список email-адресов для добавления |
💡 Максимальное количество адресов за один запрос — 10.
Пример запроса
curl -X POST "https://api.gitverse.ru/user/emails" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1" \
-d '{
"emails": [
"alice.personal@example.com",
"alice.backup@example.com"
]
}'Ответ (201 Created)
Пример JSON-ответа:
[
{
"email": "alice.personal@example.com",
"primary": false,
"verified": false,
"visibility": "private"
},
{
"email": "alice.backup@example.com",
"primary": false,
"verified": false,
"visibility": "private"
}
]Формат ответа
application/vnd.gitverse.object+json;version=1
Поля каждого email-адреса
| Поле | Тип | Описание |
|---|---|---|
email | string | Email-адрес |
primary | boolean | Является ли основным адресом аккаунта |
verified | boolean | Подтвержден ли адрес (обычно false сразу после добавления) |
visibility | string | Видимость: public или private |
Коды ответа
| Код | Статус | Описание |
|---|---|---|
| 201 | Created | Email-адреса успешно добавлены |
| 400 | Bad Request | Некорректный формат тела запроса |
| 401 | Unauthorized | Токен отсутствует или недействителен |
| 403 | Forbidden | Доступ запрещен |
| 422 | Unprocessable Entity | Один или несколько email-адресов уже существуют или недопустимы |
| 500 | Internal Server Error | Внутренняя ошибка сервера |