Клиент (/client/, /client_info/)

_{Протестировать методы API можно на странице}_{интерактивного обозревателя API}_{и без написания кода}
_{Некоторые ресурсы, описанные на странице, по умолчанию могут быть не доступны из-за типа приложения (см.}_{Создание и авторизация приложений}₎

Данный ресурс предназначен для получения информации о клиенте.

1 Описание структур данных
2 Пример
3 Ресурсы раздела "Клиент"

Описание структур данных

Имя	Тип	Описание

Имя	Тип	Описание
ambassadors	string	Контактные лица
contact_phones	string	Контактные телефоны
create_date	string	Дата создания
dial_rule_id	long	Идентификатор правила исходящих вызовов
did_as_transfer_caller_id	string	Внешний номер АТС, на который изначально пришел вызов, отображаемый при дальнейшей переадресации номера. Возможные варианты: default: вызов после переадресации уходит в том же виде, как и пришел (внешний номер АТС, на который изначально пришел вызов, не отображается) from: внешний номер АТС, на который изначально пришел вызов, после переадресации появляется в SIP поле “From” и “P-Asserted-Identity“ diversion: аналогично “default”, но внешний номер АТС, на который изначально пришел вызов, после переадресации появляется в SIP поле “Diversion“ Важно: настройка может быть переопределена другими настройками платформы, сделанными провайдером.
disk_space_notify_email	string	Адрес e-mail, на который будет отправлено письмо при достижении порогового значения дискового пространства (disk_space_notify_threshold)
disk_space_notify_threshold	long	Порог уведомления (в %) о достижении порогового значения размера дискового пространства, при котором сработает отправка письма на адрес e-mail, указанный в disk_space_notify_email
domain	string	Домен
domain_prefix	string	Префикс домена. Используется для полного набора внутреннего номера. Например, при префиксе "12345", внутренний номер 000000@domain.zone может быть вызван по номеру "12345000*000"
email	string	Адрес электронной почты
extension_len	string	Длина внутренних номеров
extra_params	string	Дополнительные параметры
fact_address	string	Фактический адрес
geo_list	string	Задает список стран, с IP-адресов которых разрешено использование SIP-аккаунта. Страны перечисляются в формате ISO 3166 Codes A2, например: "RU US BY". Если список не задан, то используется значение, определенное сервис-провайдером. Если список имеет значение "*", то все страны разрешены и параметр сервис провайдера игнорируется
hold_music	long	Идентификатор звукового файла, проигрываемого при удержании вызова
id	long	Идентификатор клиента
jur_address	string	Юридический адрес
language	string	Язык
name	string	Имя клиента
prefix	string	Префикс клиента
presence	string	yes/no: контроль доступности внутренних номеров АТС без звонка на них (зеленые - свободные, можно перевести вызов; красные - занятые)
record_format	string	Формат записи разговоров, по умолчанию mp3
record_stereo	boolean	true/false: определяет, ведется ли запись разговоров в формате “стерео”, по умолчанию false
reg_status_log	boolean	true/false: определяет, ведется ли статистика регистраций внутренних номеров. Параметр задается сервис-провайдером.
short_local_caller_id	string	Короткий внутренний идентификатор вызывающего абонента (отображение внутреннего номера без префикса АТС)
sip_network_permission_id	long	Идентификатор доверенной сети SIP. Телефоны могут авторизовываться по IP-адресам; если задан этот параметр, то это список IP-адресов, с которых в данной организации могут совершаться вызовы
timezone	string	Временная зона клиента
type	string	Тип клиента: J – юридическое лицо, F – физическое лицо
call_interactive_out_call	boolean	true/false: определяет работает ли Call Interactive (Набор с клавиатуры телефонного терминала)
call_interactive_url	string	URL запроса Call Interactive
yandex	object	Данные для различных интеграций с сервисами Яндекса. Например `"token"` для speech-to-text / text-to-speech. Максимальный размер объекта в текстовом представлении - 2000 символов.

Пример

Получим информацию о текущем авторизованном клиенте. Для этого необходимо отправить следующий запрос:

{
  "domain": "sip.ringme.ru",
  "create_date": "2020-03-16 09:29:57",
  "hold_music": null,
  "presence": "no",
  "sip_network_permission_id": null,
  "prefix": "0001",
  "record_stereo": false,
  "ambassadors": null,
  "id": 12,
  "domain_prefix": "00001",
  "contact_phones": null,
  "name": "ringme_test",
  "timezone": "Europe/Moscow",
  "dial_rule_id": 19,
  "type": "J",
  "email": "admin@domain.com",
  "reg_status_log": false,
  "fact_address": null,
  "extra_params": null,
  "extension_len": 3,
  "geo_list": null,
  "did_as_transfer_caller_id": "default",
  "jur_address": null,
  "language": null,
  "record_format": "mp3",
  "short_local_caller_id": "yes",
  "disk_space_notify_email": null,
  "disk_space_notify_threshold": null,
  "yandex": {}
}

Ресурсы раздела "Клиент"

GET /client/{client_id}/client/,

либо GET /client/client_info/{client_id}/

Получить информацию о клиенте

Параметры URL

Имя	Тип

Имя	Тип
client_id	string

Поля ответа

Имя	Тип

Имя	Тип
ambassadors	string
contact_phones	string
create_date	string
dial_rule_id	long
did_as_transfer_caller_id	string
disk_space_notify_email	string
disk_space_notify_threshold	long
domain	string
domain_prefix	string
email	string
extension_len	string
extra_params	string
fact_address	string
geo_list	string
hold_music	long
id	long
jur_address	string
language	string
name	string
prefix	string
presence	string
record_format	string
record_stereo	boolean
reg_status_log	boolean
short_local_caller_id	string
sip_network_permission_id	long
timezone	string
type	string
yandex	object

PUT /client/{client_id}/client/,

либо PUT /client/client_info/{client_id}/

Обновить настройки клиента (клиенту доступны не все параметры для обновления)

Параметры URL

Имя	Тип

Имя	Тип
client_id	string

Параметры JSON

Имя	Тип

Имя	Тип
dial_rule_id	long
disk_space_notify_email	string
disk_space_notify_threshold	long
geo_list	string
hold_music	long
sip_network_permission_id	long
timezone	string
yandex	object

Поля ответа

Имя	Тип

Имя	Тип
ambassadors	string
contact_phones	string
create_date	string
dial_rule_id	long
did_as_transfer_caller_id	string
disk_space_notify_email	string
disk_space_notify_threshold	long
domain	string
domain_prefix	string
email	string
extension_len	string
extra_params	string
fact_address	string
geo_list	string
hold_music	long
id	long
jur_address	string
language	string
name	string
prefix	string
presence	string
record_format	string
record_stereo	boolean
reg_status_log	boolean
short_local_caller_id	string
sip_network_permission_id	long
timezone	string
type	string
yandex	object

REST API Документация клиента 2.0

Клиент (/client/, /client_info/)

Analytics

Описание структур данных

Пример

Ресурсы раздела "Клиент"

Related content