...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Note |
|---|
При необходимости получения данных о регистрации для нескольких добавочный рекомендуется использовать URL вида: extension/registration/?extension_id=id1&extension_id=id2где id1 и id2 идентификаторы добавочных. Одновременно можно запрашивать до 10 добавочных (ответ придет только на первые 10 добавочных)(см. раздел "Пример") |
| Table of Contents |
|---|
Описание структур данных
...
Имя
...
Тип
...
...
contact_address
...
string
...
device
...
string
...
expires
...
integer
...
real_address
...
string
...
registration_id
...
string
...
Данные всех регистраций (RegInfo)
...
Имя
...
Тип
...
...
extension_id
...
integer
...
registered
...
boolean
...
registrations
...
array
...
Пример
Для добавочного с идентификатором 3 нужно выяснить состояние его регистраций:
...
...
...
...
...
extension/registration/?extension_id=3...
...
| Warning |
|---|
Мы обновили документацию, актуальная версия страницы доступна по ссылке: Регистрации внутреннего номера (/registration/) |
Ресурс предназначен для выяснения адресов регистрации телефонного терминала на ATC и управления ими. Для задания статической регистрации следует использовать ресурс телефонного терминала.
| Note |
|---|
При необходимости получения данных о регистрации для нескольких добавочный рекомендуется использовать URL вида: |
| Table of Contents |
|---|
Описание структур данных
Данные одной регистрации (registration)
| Anchor | ||||
|---|---|---|---|---|
|
Имя | Тип | Описание |
|---|---|---|
| string | Адрес и порт регистрации, указанный устройством при регистрации в формате address:port |
|
| Имя устройства (User Agent) |
| string | Дата (UTC), по истечении который регистрация пропадет (если не будет продлена устройстом) |
| string | Адрес и порт, откуда реально пришел запрос на регистрацию (в отличии от contact_address) |
|
| Уникальный идентификатор регистрации |
Данные всех регистраций (RegInfo)
Имя | Тип | Описание |
|---|---|---|
|
| Уникальный идентификатор добавочного |
|
| "true" если есть активные регистрации. При значении "false" массив "registrations" содержит данные о последних (уже истекших) регистрациях |
|
| Массив элементов registration |
Пример
Для добавочного с идентификатором 3 нужно выяснить состояние его регистраций:
Теперь удалить эту регистрацию:
метод | ресурс | данные | ответ |
|---|---|---|---|
| DELETE | /extension/3/registration/uloc-572b0ffb-6d47-001 | no content |
Если у клиента много добавочных, то ускорения лучше получать их блоками:
| { |
| "device":" |
| Grandstream GXP2020 1. |
| 2. |
| 5. |
| 3", |
| "real_address":"sip:xxx.xxx.xxx.xxx: |
| 5060", |
| "contact_address":"sip:000* |
| 000@192.168.5. |
| 60:5060;transport=udp", |
| "expires": |
| 1444, |
| "registration_id":"uloc- |
| 570cfe57- |
| aa6- |
| 8d4" |
| } |
| ] } |
Теперь удалить эту регистрацию:
| ] |
Ресурсы
Раздел "добавочный"
GET /extension/
...
registration/
...
...
Если у клиента много добавочных, то ускорения лучше получать их блоками (до 10 добавочных):
...
...
...
...
...
extension/registration/?extension_id=3&extension_id=2...
...
Ресурсы
Раздел "клиент"
Раздел "группа добавочных"
...
Получить статус регистрации всех добавочных
Параметры запроса
Имя | Тип |
|---|---|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
GET /extension/{extension_id}/registration/
Получить статус регистрации добавочного
Параметры URL
Имя | Тип |
|---|---|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
DELETE /extension/{extension_id}/registration/
Удалить все регистрации на добавочном
Параметры URL
Имя | Тип |
|---|---|
|
|
...
DELETE /extension/{extension_id}/registration/{registration_id}
Удалить конкретную регистрацию на добавочном
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Теги по теме
| Related Labels |
|---|