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": "example",
"is_custom": true
}
]
}Create a new firmware template into system.
Template XML file name for phone provisioning.
The file content of the template.
Created
Template XML file name for phone provisioning.
Error
POST /api/templates/phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35
{
"filename": "example",
"content": ""
}{
"filename": "xxxxxxxx"
}Retrieve details of template file by it's filename.
Template XML file name for phone provisioning.
OK
Template XML file name for phone provisioning.
The file content of the template.
Whether it's a customize template.
Error
GET /api/templates/phones/{filename} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"filename": "example",
"content": "",
"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: 14
{
"content": ""
}No content
Remove custom template by it's filename.
Template XML file name for phone provisioning.
No Content
No content
Error
POST /api/templates/phones/{filename}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
List soft phones template files
OK
Error
GET /api/templates/soft_phone HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"file_name": "example",
"is_custom": true
}
]
}Create a new soft phone template into system.
Template XML file name for phone provisioning.
The file content of the template.
Created
Template XML file name for phone provisioning.
Error
POST /api/templates/soft_phone HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"file_name": "example",
"content": ""
}{
"file_name": "xxxxxxxx"
}Retrieve details of template file by it's filename.
Template XML file name for phone provisioning.
OK
Template XML file name for phone provisioning.
The file content of the template.
Whether it's a customize template.
Error
GET /api/templates/soft_phone/{filename} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"file_name": "example",
"is_custom": true
}Update soft phone template.
Template XML file name for phone provisioning.
The file content of the template.
OK
No content
Error
POST /api/templates/soft_phone/{filename} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 14
{
"content": ""
}No content
Remove custom template by it's filename.
Template XML file name for phone provisioning.
No Content
No content
Error
POST /api/templates/soft_phone/{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": "example",
"model": "",
"display_name": "example"
}
]
}Retrieve phone template profile by it's filename.
Template XML file name for phone provisioning.
OK
Template XML file name for phone provisioning.
A collection of language tags.
A collection of country tones.
A collection of ringtones.
A collection of queue ringtones.
A collection of external ringtones.
A collection of date formats.
A collection of time formats.
A collection of time power leds.
A collection of time backlights.
A collection of screensavers.
A collection of time zones.
The list of currently enabled codec formats.
Enable or disable Link Layer Discovery Protocol.
falseEnable or disable VLAN for WAN Port.
falseVLAN ID for WAN PORT.
VLAN priority for WAN Port.
Enable or disable VLAN for PC Port.
falseVLAN ID for PC PORT.
VLAN priority for PC Port.
Error
GET /api/phone_models/{filename} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"filename": "example",
"languages": [
"English",
"Chinese"
],
"country_tones": [
"Custom",
"United States"
],
"ringtones": [
"Custom",
"United States"
],
"queue_ringtones": [
"Custom",
"United States"
],
"external_ringtone": [
"Custom",
"United States"
],
"date_formats": [],
"time_formats": [],
"powerleds": [],
"backlights": [],
"screensavers": [],
"time_zones": [
"GMT-5:00 US Eastern Time, New York"
],
"codecs": [
"PCMU",
"PCMA",
"G729",
"G722"
],
"enable_lldp": true,
"enable_vlan_wan_port": true,
"wan_port_id": 1000,
"wan_port_priority": 1,
"enable_vlan_pc_port": true,
"pc_port_id": 1000,
"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": "101",
"vendor": "",
"model": "",
"fwver": "",
"name": "example",
"password": "",
"vm_pin": "",
"ip": "127.0.0.1",
"mac": "00:1A:2B:3C:4D:5E",
"status": "OFFLINE"
}
]
}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
The extension number.
[0-9]{3,64}The phone vendor of IP phone.
The name of IP phone model.
The firmware version of IP phone.
The display name of user.
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 voicemail PIN of the phone.
IP address.
MAC address.
The status of phone.
Can be either:
ONLINE: The phone is online.OFFLINE: The phone is offline.
Not Found
GET /api/phones/{mac} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"extension_number": "101",
"vendor": "",
"model": "",
"fwver": "",
"name": "example",
"password": "xxxxxx",
"vm_pin": "",
"ip": "127.0.0.1",
"mac": "00:1A:2B:3C:4D:5E",
"status": "OFFLINE"
}Check phone's assignee by MAC.
MAC address.
OK
MAC address.
The extension number.
[0-9]{3,64}The phone vendor of IP phone.
The name of IP phone model.
Not Found
GET /api/phones/{mac}/assignee HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"mac": "00:1A:2B:3C:4D:5E",
"extension_number": "101",
"vendor": "",
"model": ""
}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": "example",
"model": "",
"lines": 50,
"display_name": "example"
}
]
}Retrieve details of DECT phone model.
Template XML file name for phone provisioning.
OK
Template XML file name for phone provisioning.
A collection of language tags.
A collection of ringtones.
A collection of time zones.
The list of currently enabled codec formats.
The max lines of DECT phone.
Error
GET /api/dect_phone_models/{name} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"template": "",
"languages": [
"English",
"Chinese"
],
"tones": [
"Custom",
"United States"
],
"time_zones": [
"GMT-5:00 US Eastern Time, New York"
],
"codecs": [
"PCMU",
"PCMA",
"G729",
"G722"
],
"lines": 50
}List DECT phones
OK
Error
GET /api/dect_phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": "xxxxxx",
"name": "example",
"mac": "00:1A:2B:3C:4D:5E",
"template": "",
"vendor": "",
"model": "",
"password": "",
"user_password": "",
"engineer_password": "",
"provisioning_pin": "123456",
"timezone": "",
"region": "",
"language": "en-US",
"handset_language": "en-US",
"tone": "",
"rps": false,
"https": false,
"codecs": [
"PCMU",
"PCMA",
"G729",
"G722"
],
"lines": 50,
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP",
"url": "https://example.com",
"firmware": "example",
"status": [
{
"display_name": "abc",
"extension_number": "101",
"status": "OFFLINE"
}
]
}
]
}Create a DECT phone.
The name of DECT 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 provisioning PIN for auto-provisioning authentication. This PIN is used to verify the phone during auto-provisioning download. It follows the same validation rules as the extension user's VOICEMAIL PIN. Can be empty, but if verification is enabled and this is empty, authentication will fail.
The timezone of phone.
The country or region name of phone.
Language for strings displayed on Phone Display LCD.
The handset language.
The country tone set of DECT phone.
Send to RPS or not.
Whether to use https
The list of currently enabled codec formats.
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
NzAwNTUxOTA5NzczMTQ4MTYwError
POST /api/dect_phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 369
{
"name": "example",
"mac": "00:1A:2B:3C:4D:5E",
"template": "",
"vendor": "",
"model": "",
"password": "",
"user_password": "",
"engineer_password": "",
"provisioning_pin": "123456",
"timezone": "",
"region": "",
"language": "English",
"handset_language": "English",
"tone": "",
"rps": false,
"https": false,
"codecs": [
"PCMU",
"PCMA",
"G729",
"G722"
],
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP"
}{
"id": "xxxxxxxx"
}Retrieve DECT phone's detailed information.
NzAwNTUxOTA5NzczMTQ4MTYwOK
NzAwNTUxOTA5NzczMTQ4MTYwThe name of DECT 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 provisioning PIN for auto-provisioning authentication. This PIN is used to verify the phone during auto-provisioning download. It follows the same validation rules as the extension user's VOICEMAIL PIN. Can be empty, but if verification is enabled and this is empty, authentication will fail.
The timezone of phone.
The country or region name of phone.
Language for strings displayed on Phone Display LCD.
The handset language.
The country tone set of DECT phone.
Send to RPS or not.
Whether to use https
The list of currently enabled codec formats.
The max lines of DECT phone.
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:
Auto provision server URL.
The firmware of phone.
Not Found
GET /api/dect_phones/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "xxxxxx",
"name": "example",
"mac": "00:1A:2B:3C:4D:5E",
"template": "",
"vendor": "",
"model": "",
"password": "",
"user_password": "",
"engineer_password": "",
"provisioning_pin": "123456",
"timezone": "",
"region": "",
"language": "en-US",
"handset_language": "en-US",
"tone": "",
"rps": false,
"https": false,
"codecs": [
"PCMU",
"PCMA",
"G729",
"G722"
],
"lines": 50,
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP",
"url": "https://example.com",
"firmware": "example",
"status": [
{
"display_name": "abc",
"extension_number": "101",
"status": "OFFLINE"
}
]
}Update a DECT phone.
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 provisioning PIN for auto-provisioning authentication. This PIN is used to verify the phone during auto-provisioning download. It follows the same validation rules as the extension user's VOICEMAIL PIN. Can be empty, but if verification is enabled and this is empty, authentication will fail.
The timezone of phone.
The country or region name of phone.
Language for strings displayed on Phone Display LCD.
The handset language.
The country tone set of DECT phone.
Send to RPS or not.
Whether to use https
The list of currently enabled codec formats.
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: 302
{
"name": "example",
"password": "",
"user_password": "",
"engineer_password": "",
"provisioning_pin": "123456",
"timezone": "",
"region": "",
"language": "en-US",
"handset_language": "en-US",
"tone": "",
"rps": false,
"https": false,
"codecs": [
"PCMU",
"PCMA",
"G729",
"G722"
],
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP"
}No content
Delete a DECT phone by it's ID.
NzAwNTUxOTA5NzczMTQ4MTYwNo Content
No 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.
NzAwNTUxOTA5NzczMTQ4MTYwOK
Error
GET /api/dect_phones/{id}/members HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": "xxxxxx",
"extension_number": "101",
"display_name": "example",
"ipui": "",
"handset_index": ""
}
]
}Update DECT phone member list.
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: 67
{
"items": [
{
"extension_number": "101",
"ipui": "",
"handset_index": ""
}
]
}No content
Check if extension is in DECT phone member list.
NzAwNTUxOTA5NzczMTQ4MTYwThe extension number.
[0-9]{3,64}OK
NzAwNTUxOTA5NzczMTQ4MTYwThe extension number.
[0-9]{3,64}The display name of user.
The International Portable User Identity.
The handset index.
Not Found
GET /api/dect_phones/{id}/members/{extension_number} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "xxxxxx",
"extension_number": "101",
"display_name": "example",
"ipui": "",
"handset_index": ""
}Last updated
Was this helpful?