Изменить адреса электронной почты
Изменяет электронные адреса внешнего контакта.
Полностью заменяет список текущих адресов. Новый список не может быть пустым. В новом списке должен быть ровно один адрес с флагом main=true — основной электронный адрес. На него будут отправляться письма, если выбрать контакт в качестве получателя.
Request
PUT
https://api360.yandex.net/directory/v1/org/{orgId}/external_contacts/{contactId}/emails
Path parameters
|
Name |
Description |
|
contactId* |
Type: string Идентификатор внешнего контакта. |
|
orgId* |
Type: integer<int64> Идентификатор организации. |
Body
application/json
{
"emails": [
{
"email": "string",
"type": "string",
"main": false
}
]
}
|
Name |
Description |
|
emails* |
Type: v1ExternalContactEmail[] Электронные адреса. |
v1ExternalContactEmail
|
Name |
Description |
|
|
Type: string Электронный адрес. |
|
main |
Type: boolean Признак основного электронного адреса:
|
|
type |
Type: string Тип электронного адреса. Возможные значения:
|
Responses
200 OK
Запрос успешно выполнен.
Body
application/json
{
"id": "string"
}
|
Name |
Description |
|
id* |
Type: string Идентификатор внешнего контакта. |
400 Bad Request
Некорректный запрос.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
protobufAny
|
Name |
Description |
|
@type |
Type: string |
|
[additional] |
Type: any |
401 Unauthorized
Пользователь не авторизован.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
403 Forbidden
У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
500 Internal Server Error
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
No longer supported, please use an alternative and newer version.