Versions Compared

Key

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

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

Note

При необходимости получения данных о регистрации для нескольких добавочный рекомендуется использовать URL вида:

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

(см. раздел "Пример")

 

Table of Contents

...

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

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

...

Имя

Тип

Описание

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

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

...

Пример

Для добавочного с  идентификатором 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:213.170.78.202: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:213.170.78.202:5060",
                "contact_address":"sip:000*000@192.168.5.60:5060;transport=udp",
                "expires":1444,
                "registration_id":"uloc-570cfe57-aa6-8d4"
            }
        ]
    }
]

Ресурсы

Раздел "клиент"

Раздел "группа добавочных"

Раздел "добавочный"

Теги по теме

Related Labels