Изменить номера телефонов

Изменяет телефонные номера внешнего контакта.

Полностью заменяет список текущих телефонов. Новый список может быть пустым. В новом списке может быть не более одного телефона с флагом main=true.

Request

PUT

https://api360.yandex.net/directory/v1/org/{orgId}/external_contacts/{contactId}/phones

Path parameters

Name

Description

contactId*

Type: string

Идентификатор внешнего контакта.

orgId*

Type: integer<int64>

Идентификатор организации.

Body

application/json
{
    "phones": [
        {
            "phone": "string",
            "type": "string",
            "main": false
        }
    ]
}

Name

Description

phones*

Type: v1ExternalContactPhone[]

Телефоны.

v1ExternalContactPhone

Name

Description

main

Type: boolean

Признак основного телефона:

  • true — основной (может быть не более чем у одного телефона);
  • false — дополнительный.

phone

Type: string

Телефон.

type

Type: string

Тип телефона. Возможные значения:

  • work — рабочий телефон;
  • mobile — мобильный телефон;
  • ip — IP-телефон;
  • для порочих телефоных номеров оставьте поле незаполненным.

Responses

200 OK

Запрос успешно выполнен.

Body

application/json
{
    "id": "string"
}

Name

Description

id*

Type: string

Идентификатор внешнего контакта.

401 Unauthorized

Пользователь не авторизован.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

403 Forbidden

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.