Клиент

Данный ресурс предназначен для создания клиентов АТС и управления ими.

Описание полей ресурса

Имя	Тип	Описание	Обязательное	Значение по умолчанию
`name`	`string`	Имя клиента	да
`dealer_id`	`integer`	Идентификатор дилера клиента. Дилер определяет общие настройки для всех своих клиентов, такие как правила маршрутизации, различные лимиты, правила набора, предпочитаемые медиа-сервера и прочие.	да
`domain_id`	`integer`	Идентификатор домена клиента. Все добавочные клиента имеют номера в формате префикс_клиентаимя_добавочного@домен_клиента.* Поле только для чтения.	да
`email`	`string`	Адрес электронной почты клиента	да
`prefix`	`string`	Префикс клиента. Все добавочные клиента имеют номера в формате префикс_клиентаимя_добавочного@домен_клиента.* Поле только для чтения.	-	-
`id`	`integer`	Уникальный идентификатор клиента. Поле только для чтения.	-	-
`create_date`	`string`	Дата создания клиента в формате YYYY-MM-DD HH:MM:SS. Поле только для чтения.	-	-
`extension_len`	`integer(2,3,4)`	Длина номеров добавочных клиента. Может принимать значения 2, 3, или 4. Не может быть изменена после создания клиента.	нет	3
`status`	`string(`"active", "blocked")	Статус клиента. Может принимать значения active и blocked. При установленном статусе blocked клиент не может принимать и совершать вызовы, а также пользоваться REST API.	нет	active
`presence`	`string("yes","no")`	Включить (значение yes) или отключить (значение no) службу presence для клиента. Если служба включена, добавочные клиента могут подписывапться на события presence и dialog.	нет	no
`sbc_mode`	`string(`"yes","no")	Включить (значение yes) или отключить (значение no) режим sbc для клиента. Если режим SBC включен, то медиаданные для добавочных клиента будет проходить через тот же адрес, что и SIP-сообщения. Режим SBC может быть использован в случае, когда межсетевой экран клиента разрешает соединение только с одним адресом. Если поле имеет значение null, используется настройка дилера.	нет	null
`routing_list_id`	`integer`	Идентификатор списка правил маршрутизации исходящих клиента. При значении null будет использован список маршрутизации дилера.	нет	null
`short_local_caller_id`	`string("yes","no")`	Использование короткого номера идентификатора звонящего при вызовах между добавочными клиента. Если настройка включена (значение yes), то при вызовах с добавочного клиента на другой добавочных этого же клиента в поле From вместо полного имени добавочного (000*100@sip.ringme.ru) с префиксом клиента будет находится короткое имя добавочного без префикса клиента (100@sip.ringme.ru).	нет	no
`language`	`string(`"ru","en")	Язык клиента. На языке клиента проигрываются звуковые файлы приветствий голосовой почты, перевода, звуки управления конференцией. Если имеет значение null, используется глобальный язык инсталляции АТС.	нет	null
`disk_quota`	`integer`	Дисковая квота в байтах для хранения записей разговора, сообщений голосовой почты и входящий сообщений факса. При исчерпании квоты запись разговоров, сохранение голосовых сообщений и приём факсов вестись не будет.	нет	0
`reg_limit`	`integer`	Лимит на количество одновременных регистраций одного добавочного клиента. Значение 0 означает, что каждая новая регистрация будет отменять предыдущую, при значениях больше нуля при достижении лимита регистраций новые будут отклоняться.	нет	0
`calls_limit`	`integer`	Лимит на количество одновременных вызовов клиента. При значении null будет использован лимит дилера.	нет	null
`extension_limit`	`integer`	Лимит на количество добавочных. Если имеет значение null, используется глобальный лимит.	нет	null
`extension_group_limit`	`integer`	Лимит на количество групп добавочных. Если имеет значение null, используется глобальный лимит.	нет	null
`sound_limit`	`integer`	Лимит на количество загружаемых клиентом звуковых файлов. Если имеет значение null, используется глобальный лимит.	нет	null
`extension_agent_limit`	`integer`	Лимит на количество агентов очереди на один добавочных клиента. Если имеет значение null, используется глобальный лимит.	нет	null
`remote_agent_limit`	`integer`	Лимит на количество внешних агентов очередей. Если имеет значение null, используется глобальный лимит.	нет	null
`ivr_rule_limit`	`integer`	Лимит на количество правил в одной опции контекста IVR. Если имеет значение null, используется глобальный лимит.	нет	null
`ivr_option_limit`	`integer`	Лимит на количество опций одного контекста IVR. Если имеет значение null, используется глобальный лимит.	нет	null
`ivr_context_limit`	`integer`	Лимит на количество контекстов в одном добавочном типа IVR. Если имеет значение null, используется глобальный лимит.	нет	null
`incom_rule_limit`	`integer`	Лимит на количество правил входящего вызова одного добавочного. Если имеет значение null, используется глобальный лимит.	нет	null
`dial_rule_limit`	`integer`	Лимит на количество правил набора клиента. Если имеет значение null, используется глобальный лимит.	нет	null
`user_extension_limit`	`integer`	Лимит на количество пользователей типа "добавочный". Если имеет значение null, используется глобальный лимит.	нет	null
`user_extension_group_limit`	`integer`	Лимит на количество пользователей типа "группа добавочных". Если имеет значение null, используется глобальный лимит.	нет	null
`user_client_limit`	`integer`	Лимит на количество пользователей типа "клиент". Если имеет значение null, используется глобальный лимит.	нет	null
`interval_limit`	`integer`	Лимит на количество временных интервалов клиента. Если имеет значение null, используется глобальный лимит.	нет	null
`event_limit`	`integer`	Лимит на количество обработчиков событий на одном добавочном. Если имеет значение null, используется глобальный лимит.	нет	null
`application_limit`	`integer`	Лимит на количество приложений API клиента. Если имеет значение null, используется глобальный лимит.	нет	null
`network_permission_limit`	`integer`	Лимит на количество списков разрешенных сетей, которые используются для авторизации и регистрации добавочных с типами авторизации network и both. Если имеет значение null, используется глобальный лимит	нет	null
`hidden_json`	`string`	Строковое поле, где может быть сохранена любая информация о клиенте, например, о подключенных ему услугах. Клиенту поле не доступно.	нет	null
`hidden_comment`	`string`	Комментарий о клиенте. Может быть использован для сохранения любой информации о клиенте. Клиенту поле не доступно.	нет	null
`extra_params`	`string`	Строковое поля для любой дополнительной информации о клиенте. Клиенту данное поле доступно на чтение.	нет	null
`type`	`string("J","F")`	Тип клиента, информационное поле. Значение F означает физическое лицо, значение J – юридическое.	нет	F
`ambassadors`	`string`	Контактные лица клиента, информационное поле.	нет	null
`contact_phones`	`string`	Контактные телефоны клиента, информационное поле.	нет	null
`jur_address`	`string`	Юридический адрес клиента, информационное поле.	нет	null
`fact_address`	`string`	Фактический адрес клиента, информационное поле.	нет	null

Ресурсы раздела "Администратор"

POST /admin/client/

Добавить нового клиента

Параметры JSON

Поля клиента

Поля ответа

Поля клиента

`GET /admin/client/`

Получить список клиентов системы. Возможна фильтрация результатов с помощью полей запроса.

Параметры запроса

Имя	Тип
`extension_len`	`array [integer]`
`dealer_id`	`array [integer]`
`name`	`array [string]`
`domain_id`	`array [integer]`
`routing_list_id`	`array [integer]`
`id`	`array [integer]`
`prefix`	`array [string]`
`order_by`	`string`
`per_page`	`integer`
`type`	`array [string]`
`order`	`string`
`page`	`integer`

Поля ответа

Поля клиента

`PUT /admin/client/{client_id`}

Обновить клиента

Параметры URL

Имя	Тип
`client_id`	`integer`

Параметры JSON

Поля клиента

Поля ответа

Поля клиента

`GET /admin/client/{client_id`}

Получить клиента

Параметры URL

Имя	Тип
`client_id`	`integer`

Поля ответа

Поля клиента

`DELETE /admin/client/{client_id`}

Удалить клиента. Если передан параметр запроса delete_dids и он имеет значение true, то did'ы клиента будут удалены из системы. В противном случае, они будут отвязаны от удаляемого клиента.

Параметры URL

Имя	Тип
`client_id`	`integer`

Параметры запроса

Имя	Тип	По умолчанию
`delete_dids`	`boolean`	false

Клиент

Описание полей ресурса

Ресурсы раздела "Администратор"

POST /admin/client/

Параметры JSON

Поля ответа

GET /admin/client/

Параметры запроса

Поля ответа

PUT /admin/client/{client_id}

Параметры URL

Параметры JSON

Поля ответа

GET /admin/client/{client_id}

Параметры URL

Поля ответа

DELETE /admin/client/{client_id}

Параметры URL

Параметры запроса

`GET /admin/client/`

`PUT /admin/client/{client_id`}

`GET /admin/client/{client_id`}

`DELETE /admin/client/{client_id`}