Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...


Warning

Мы обновили документацию, актуальная версия страницы доступна по ссылке: Регистрации внутреннего номера (/registration/)

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

Note

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

 


Table of Contents

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

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

Количество секунд

Имя

Тип

Описание

contact_address

string

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

device

string

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

expires

integer

string

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

real_address

string

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

registration_id

string

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

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

Имя

Тип

Описание

extension_id

integer

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

registered

boolean

"true" если есть активные регистрации. При значении "false" массив "registrations" содержит данные о последних (уже истекших) регистрациях

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


Теги по теме

Related Labels