Auto Provisioning
Manage your phone auto provisioning.
List IP phones template files
OK
Error
GET /api/templates/phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"filename": "text",
"is_custom": true
}
]
}Create a new firmware template into system.
Template XML file name for phone provisioning.
The file content of the template.
Created
Error
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.
OK
Error
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.
OK
No content
Error
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.
No Content
Error
POST /api/templates/phones/{filename}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
List IP phones models.
OK
Error
GET /api/phone_models HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"filename": "text",
"model": "text",
"display_name": "text"
}
]
}Retrieve phone template profile by it's filename.
Template XML file name for phone provisioning.
OK
Error
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
OK
Error
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"
}
]
}Re-provision all phones.
OK
No content
Error
POST /api/phones/reprovision HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Retrieve phone's detailed information.
MAC address.
OK
Not Found
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.
OK
Not Found
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"
}Re-provision a phone by it's MAC address.
MAC address.
OK
No content
Error
POST /api/phones/{mac}/reprovision HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Reboot Phone
MAC address.
OK
No content
Error
POST /api/phones/{mac}/reboot HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Reject a phone from auto provisioning.
MAC address.
OK
No content
Invalid mac address.
POST /api/phones/{mac}/reject HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
List DECT phone models.
OK
Error
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.
OK
Error
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
OK
Error
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:
Created
Error
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.
NzAwNTUxOTA5NzczMTQ4MTYwOK
Not Found
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.
NzAwNTUxOTA5NzczMTQ4MTYwThe 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:
OK
No content
Error
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.
NzAwNTUxOTA5NzczMTQ4MTYwNo Content
Error
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.
NzAwNTUxOTA5NzczMTQ4MTYwOK
Error
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.
NzAwNTUxOTA5NzczMTQ4MTYwOK
No content
Error
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.
NzAwNTUxOTA5NzczMTQ4MTYwThe extension number.
[0-9]{3,64}OK
Not Found
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"
}Last updated