Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Ресурс предназначен для выяcнения адресов регистрации телефонного терминала на ATC и управления ими. Для задания статической регистрации следует использовать ресурс телефонного терминала.

При необходимости получения данных о регистрации для нескольких добавочный рекомендуется использовать URL вида:
extension/registration/?extension_id=id1&extension_id=id2
где id1 и id2 идентификаторы добавочных. Одновременно можно запрашивать до 10 добавочных (ответ придет только на первые 10 добавочных)
(см. раздел "Пример")

 

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

Данные одной регистрации (registration)

Имя

Тип

Описание

contact_address

string

Адрес и порт регистрации, указанный устройством при регистрации в формате address:port

device

string

Имя устройства (User Agent)

expires

integer

Количество секунд, по истечении который регистрация пропадет (если не будет продлена устройстом)

real_address

string

Адрес и порт, откуда реально пришел запрос на регистрацию (в отличии от contact_address)

registration_id

string

Уникальный идентификатор регистрации

Данные всех регистраций (RegInfo)

Имя

Тип

Описание

extension_id

integer

Уникальный идентификатор добавочного

registered

boolean

"true" если есть активные регистрации

registrations

array

Массив элементов registration

Пример

Для добавочного с  идентификатором 3 нужно выяснить состояние его регистраций:

метод
ресурс
данные
ответ
GET
extension/registration/?extension_id=3

 

{   
   "registered":true,
   "extension_id":3,
   "registrations":[   
      {   
         "device":"Yealink SIP-T46G 28.72.14.5",
         "real_address":"sip:xxx.xxx.xxx.xxx:62338",
         "contact_address":"sip:000*002@192.168.5.52:5062",
         "expires":699,
         "registration_id": "uloc-572b0ffb-6d47-001"
      }
   ]
}

Теперь удалить эту регистрацию:

метод
ресурс
данные
ответ
DELETE
/extension/3/registration/uloc-572b0ffb-6d47-001

 

no content

Если у клиента много добавочных, то ускорения лучше получать их блоками (до 10 добавочных):

метод
ресурс
данные
ответ
GET
extension/registration/?extension_id=3&extension_id=2

 

[   
    {   
        "registered":true,
        "extension_id":3,
        "registrations":[   
            {   
                "device":"Yealink SIP-T46G 28.72.14.5",
                "real_address":"sip:xxx.xxx.xxx.xxx:62338",
                "contact_address":"sip:000*002@192.168.5.52:5062",
                "expires":1764,
                "registration_id":"uloc-5731d93c-4a88-51"
            }
        ]
    },
    {   
        "registered":true,
        "extension_id":2,
        "registrations":[   
            {   
                "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/

Получить extension registration status

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

Имя

Тип

extension_id

array [integer]

Поля ответа

Имя

Тип

registered

boolean

extension_id

integer

registrations

array [registration]

 

GET /extension/{extension_id}/registration/

Получить extension registration status

Параметры URL

Имя

Тип

extension_id

string

Поля ответа

Имя

Тип

registered

boolean

extension_id

integer

registrations

array [registration]

DELETE /extension/{extension_id}/registration/

Удалить all extension registrations

Параметры URL

Имя

Тип

extension_id

string

DELETE /extension/{extension_id}/registration/{registration_id}

Удалить registration

Параметры URL

Имя

Тип

registration_id

string

extension_id

string


Теги по теме

There are no related labels.

  • No labels