Публичный APIПользователи4. POST /user/emails — добавить новые email-адреса

4. POST /user/emails — добавить новые email-адреса

Описание

Добавляет один или несколько новых email-адресов к аккаунту авторизованного пользователя.
Каждый добавленный адрес требует подтверждения через email (если включена верификация).

⚠️ Требуется действительный токен авторизации с правами на управление профилем.

Параметры URL

Данный метод не содержит параметров пути.

Параметры запроса

Данный метод не принимает параметров в строке запроса.

Тело запроса

Тело запроса обязательно и должно быть в формате JSON.

ПолеТипОбязательныйОписание
emailsarrayДаСписок 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-адреса

ПолеТипОписание
emailstringEmail-адрес
primarybooleanЯвляется ли основным адресом аккаунта
verifiedbooleanПодтвержден ли адрес (обычно false сразу после добавления)
visibilitystringВидимость: public или private

Коды ответа

КодСтатусОписание
201CreatedEmail-адреса успешно добавлены
400Bad RequestНекорректный формат тела запроса
401UnauthorizedТокен отсутствует или недействителен
403ForbiddenДоступ запрещен
422Unprocessable EntityОдин или несколько email-адресов уже существуют или недопустимы
500Internal Server ErrorВнутренняя ошибка сервера