Добавление новых email-адресов пользователя
Beta
New

⚠️

Ограниченный доступ

Описание

Этот раздел документации описывает конечную точку для добавления одного или нескольких новых email-адресов к аккаунту аутентифицированного пользователя. После добавления email-адреса помечаются как неподтверждённые, и система отправляет ссылки для верификации на указанные адреса.

Общие замечания

Для версий API указывайте заголовок Accept с соответствующей версией:
```
Accept: application/vnd.gitverse+json;version=1
```
Базовый URL для всех конечных точек:
```
https://api.gitverse.ru
```
Все данные возвращаются в формате JSON.
Если запрос завершается неудачно, API возвращает объект ошибки с кодом состояния HTTP и сообщением.

Скоупы

Для успешного выполнения этого запроса требуется один из следующих скоупов:

"write:public_api";
"public_api".

Конечная точка

POST /user/emails

Параметры пути

Нет обязательных параметров пути. Конечная точка /user/emails автоматически определяет текущего аутентифицированного пользователя на основе предоставленного токена.

Заголовки запроса

Content-Type: application/json — указывает, что тело запроса имеет формат JSON;
Accept: application/vnd.gitverse+json;version=1 — указывает версию API;
Authorization: Bearer {user_token} — требуется для аутентификации.

Тело запроса

Тело запроса должно содержать массив email-адресов:

Поле	Тип	Описание
`emails`	array of strings	Массив email-адресов, которые необходимо добавить.

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

POST https://api.gitverse.ru/user/emails
Content-Type: application/json
Accept: application/vnd.gitverse+json;version=1
Authorization: Bearer YOUR_ACCESS_TOKEN
 
{
  "emails": ["new4@example.com", "new5@example.com", "new6@example.com"]
}

Пример ответа

[
    {
        "email": "new4@example.com",
        "verified": true,
        "primary": false,
        "is_public": false
    },
    {
        "email": "new5@example.com",
        "verified": true,
        "primary": false,
        "is_public": false
    },
    {
        "email": "new6@example.com",
        "verified": true,
        "primary": false,
        "is_public": false
    }
]

Поля ответа

Каждый элемент массива представляет собой объект email-адреса со следующими полями:

Поле	Тип	Описание
`email`	string	Email-адрес пользователя.
`verified`	boolean	Подтверждён ли адрес электронной почты.
`primary`	boolean	Является ли этот email основным.
`is_public`	boolean	Доступен ли email другим пользователям (публичный/приватный).

Обработка ошибок

Если запрос завершается неудачно, API возвращает объект ошибки с кодом состояния HTTP и сообщением:

Пример ошибки

{
  "error": "Unauthorized",
  "message": "Authentication failed. Invalid or missing access token.",
  "status": 401
}

Возможные коды ошибок

400 Bad Request — некорректный запрос или невалидные email-адреса;
401 Unauthorized — необходима аутентификация. Отсутствует или неверен токен;
403 Forbidden — у пользователя нет прав для добавления email-адресов;
500 Internal Server Error — внутренняя ошибка сервера.

Следующие шаги

После добавления email-адресов вы можете:

получить список email-адресов с помощью метода GET /user/emails;
удалить ненужные адреса через отдельный эндпоинт (если доступен);
установить один из адресов как основной или изменить его видимость через другие методы API.

Если у вас возникнут вопросы или потребуется дополнительная информация, пожалуйста, обращайтесь в службу поддержки или свяжитесь с командой разработки.

Получение данных о пользователях Получение списка email-адресов пользователя

Добавление новых email-адресов пользователяBetaNew