3. GET /user/emails — получить список email-адресов пользователя
Описание
Возвращает список всех email-адресов, привязанных к аккаунту авторизованного пользователя, включая основной и дополнительные адреса.
⚠️ Требуется действительный токен авторизации с правами на чтение профиля.
Параметры URL
Данный метод не содержит параметров пути.
Параметры запроса
| Параметр | Тип | Обязательный | Описание | По умолчанию |
|---|---|---|---|---|
page | integer | Нет | Номер страницы результатов | 1 |
per_page | integer | Нет | Количество адресов на странице (максимум — 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-адреса
| Поле | Тип | Описание |
|---|---|---|
email | string | Email-адрес |
primary | boolean | Является ли основным адресом аккаунта |
verified | boolean | Подтвержден ли адрес (через email-верификацию) |
visibility | string | Видимость: public или private |
Коды ответа
| Код | Статус | Описание |
|---|---|---|
| 200 | OK | Список email-адресов успешно получен |
| 400 | Bad Request | Некорректные параметры пагинации |
| 401 | Unauthorized | Токен отсутствует или недействителен |
| 403 | Forbidden | Доступ к email-адресам запрещен |
| 500 | Internal Server Error | Внутренняя ошибка сервера |