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

3. GET /user/emails — получить список email-адресов пользователя

Описание

Возвращает список всех email-адресов, привязанных к аккаунту авторизованного пользователя, включая основной и дополнительные адреса.

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

Параметры URL

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

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

ПараметрТипОбязательныйОписаниеПо умолчанию
pageintegerНетНомер страницы результатов1
per_pageintegerНетКоличество адресов на странице (максимум — 50)30

Тело запроса

Данный метод не требует тела запроса.

Пример запроса

curl -X GET "https://api.gitverse.ru/user/emails?page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

Ответ (200 OK)

Пример JSON-ответа:

[
  {
    "email": "alice@example.com",
    "primary": true,
    "verified": true,
    "visibility": "public"
  },
  {
    "email": "alice.backup@example.com",
    "primary": false,
    "verified": true,
    "visibility": "private"
  }
]

Формат ответа

application/vnd.gitverse.object+json;version=1

Поля каждого email-адреса

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

Коды ответа

КодСтатусОписание
200OKСписок email-адресов успешно получен
400Bad RequestНекорректные параметры пагинации
401UnauthorizedТокен отсутствует или недействителен
403ForbiddenДоступ к email-адресам запрещен
500Internal Server ErrorВнутренняя ошибка сервера