Auto Provisioning
Manage your phone auto provisioning.
Create a new firmware template into system.
Template XML file name for phone provisioning.
The file content of the template.
POST /api/templates/phones HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"filename": "text",
"content": "text"
}
{
"filename": "text"
}
Retrieve details of template file by it's filename.
Template XML file name for phone provisioning.
GET /api/templates/phones/{filename} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"filename": "text",
"content": "text",
"is_custom": true
}
Update phone template.
Template XML file name for phone provisioning.
The file content of the template.
POST /api/templates/phones/{filename} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"content": "text"
}
No content
Remove custom template by it's filename.
Template XML file name for phone provisioning.
POST /api/templates/phones/{filename}/destroy HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Retrieve phone template profile by it's filename.
Template XML file name for phone provisioning.
GET /api/phone_models/{filename} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"filename": "text",
"languages": [
"ENGLISH"
],
"ringtones": [
"text"
],
"queue_ringtones": [
"text"
],
"external_ringtone": [
"text"
],
"date_formats": [
"text"
],
"time_formats": [
"text"
],
"powerleds": [
"text"
],
"backlights": [
"text"
],
"screensavers": [
"text"
],
"time_zones": [
"text"
],
"codecs": [
"text"
],
"enable_lldp": false,
"enable_vlan_wan_port": false,
"wan_port_id": 1,
"wan_port_priority": 1,
"enable_vlan_pc_port": false,
"pc_port_id": 1,
"pc_port_priority": 1
}
List IP phones
GET /api/phones HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"extension_number": "text",
"vendor": "text",
"model": "text",
"fwver": "text",
"name": "text",
"password": "text",
"vm_pin": "text",
"ip": "text",
"mac": "text"
}
]
}
Retrieve phone's detailed information.
MAC address.
GET /api/phones/{mac} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"extension_number": "text",
"vendor": "text",
"model": "text",
"fwver": "text",
"name": "text",
"password": "text",
"vm_pin": "text",
"ip": "text",
"mac": "text"
}
Check phone's assignee by MAC.
MAC address.
GET /api/phones/{mac}/assignee HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"mac": "text",
"extension_number": "text",
"vendor": "text",
"model": "text"
}
List DECT phone models.
GET /api/dect_phone_models HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"filename": "text",
"model": "text",
"lines": 1,
"display_name": "text"
}
]
}
Retrieve details of DECT phone model.
Template XML file name for phone provisioning.
GET /api/dect_phone_models/{name} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"template": "text",
"languages": [
"ENGLISH"
],
"tones": [
"text"
],
"time_zones": [
"text"
],
"codecs": [
"text"
],
"lines": 1
}
List DECT phones
GET /api/dect_phones HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"mac": "text",
"template": "text",
"vendor": "text",
"model": "text",
"password": "text",
"user_password": "text",
"engineer_password": "text",
"timezone": "text",
"region": "text",
"language": "ENGLISH",
"handset_language": "ENGLISH",
"tone": "text",
"rps": true,
"https": true,
"codecs": [
"text"
],
"lines": 1,
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP",
"url": "text"
}
]
}
Create a DECT phone.
The name of DECT phone.
MAC address of this IP phone.
MAC address.
Template XML file name for phone provisioning.
The phone vendor of IP phone.
The name of IP phone model.
Password for accessing the Web interface of phone. The username remains default because most phone manufacturers do not allow modification of the user name. This is supported for some phone model, such as "Snom 300".
The user password.
The engineer password.
The timezone of phone.
The country or region name of phone.
Language for strings displayed on Phone Display LCD. Supported languages include ENGLISH, CHINESE, DUTCH, FRENCH, GERMAN, GREEK, ITALIAN, JAPANESE, POLISH, RUSSIAN, SPANISH, SWEDISH, UKRAINIAN, and BULGARIAN.
The handset language.
The tone set of DECT phone.
Send to RPS or not.
Whether to use https
Settings for the priority of the codecs in this phone. This indicates the first preferred codec.
The interface type for QR code or auto provisioning.
Can be neither:
WEB_DOMAIN
:PUBLIC_IPV4
:PUBLIC_IPV6
:PRIVATE_IPV4
:PRIVATE_IPV6
:SBC_DOMAIN
:
The transport protocol:
Can be either:
UDP
:TCP
:TLS
:
POST /api/dect_phones HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 338
{
"name": "text",
"mac": "text",
"template": "text",
"vendor": "text",
"model": "text",
"password": "text",
"user_password": "text",
"engineer_password": "text",
"timezone": "text",
"region": "text",
"language": "ENGLISH",
"handset_language": "ENGLISH",
"tone": "text",
"rps": true,
"https": true,
"codecs": [
"text"
],
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP"
}
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw"
}
Retrieve DECT phone's detailed information.
The unique ID of DECT phone.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
GET /api/dect_phones/{id} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"mac": "text",
"template": "text",
"vendor": "text",
"model": "text",
"password": "text",
"user_password": "text",
"engineer_password": "text",
"timezone": "text",
"region": "text",
"language": "ENGLISH",
"handset_language": "ENGLISH",
"tone": "text",
"rps": true,
"https": true,
"codecs": [
"text"
],
"lines": 1,
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP",
"url": "text"
}
Update a DECT phone.
The unique ID of DECT phone.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
The name of DECT phone.
Password for accessing the Web interface of phone. The username remains default because most phone manufacturers do not allow modification of the user name. This is supported for some phone model, such as "Snom 300".
The user password.
The engineer password.
The timezone of phone.
The country or region name of phone.
Language for strings displayed on Phone Display LCD. Supported languages include ENGLISH, CHINESE, DUTCH, FRENCH, GERMAN, GREEK, ITALIAN, JAPANESE, POLISH, RUSSIAN, SPANISH, SWEDISH, UKRAINIAN, and BULGARIAN.
The handset language.
The tone set of DECT phone.
Send to RPS or not.
Whether to use https
Settings for the priority of the codecs in this phone. This indicates the first preferred codec.
The interface type for QR code or auto provisioning.
Can be neither:
WEB_DOMAIN
:PUBLIC_IPV4
:PUBLIC_IPV6
:PRIVATE_IPV4
:PRIVATE_IPV6
:SBC_DOMAIN
:
The transport protocol:
Can be either:
UDP
:TCP
:TLS
:
POST /api/dect_phones/{id} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 276
{
"name": "text",
"password": "text",
"user_password": "text",
"engineer_password": "text",
"timezone": "text",
"region": "text",
"language": "ENGLISH",
"handset_language": "ENGLISH",
"tone": "text",
"rps": true,
"https": true,
"codecs": [
"text"
],
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP"
}
No content
Delete a DECT phone by it's ID.
The unique ID of DECT phone.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
POST /api/dect_phones/{id}/destroy HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Retrieve a collection of DECT phone members.
The unique ID of DECT phone.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
GET /api/dect_phones/{id}/members HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"extension_number": "text",
"display_name": "text",
"ipui": "text",
"handset_index": "text"
}
]
}
Update DECT phone member list.
The unique ID of DECT phone.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
POST /api/dect_phones/{id}/members HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 76
{
"items": [
{
"extension_number": "text",
"ipui": "text",
"handset_index": "text"
}
]
}
No content
Check if extension is in DECT phone member list.
The unique ID of DECT phone.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
The extension number.
[0-9]{3,64}
GET /api/dect_phones/{id}/members/{extension_number} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"extension_number": "text",
"display_name": "text",
"ipui": "text",
"handset_index": "text"
}