The interface between client and server is built as XML-RPC services. To access them you may use XMLRPC libraries available in the internet or do it yourself by sending XML documents described further down via HTTP POST requests.
The XML-RPC interface is secured and encrypted via TLS, user authentication is done via HTTP basic authentication mechanism.
Creating an XML-RPC client
- The URL for XML-RPC requests is https://secure-provisioning.snom.com:8083/xmlrpc/ the trailing slash ("/") is mandatory.
- The header Content-type: text/xml is mandatory
- All XML-RPC methods must be prefixed by the redirection namespace (eg. redirect.registerPhone )
|Method XML signature||Description||Parameters||Return|
|Register a device mac address redirection to a specific URL|
|Deregister a specific mac from the servi e|
|redirect.getPhoneRedirection(mac)||Retrieve the redirection URL of a specific mac|
|List all the registered mac address of a given type or optionally redirected to a particular URL|
Checks if a device is registered to the requesting user.
Register a list of MACs at the redirection service in order to redirect the specified phones to a different setting server.
|Deregister a list of MACs|
XML-RPC exchange snippets
The following code snippets are examples using the curl command as a tool to send the XML-RPC request.
Registering a device
Deregistering a device
Get a device redirection
List registered phones by model
List registered phones by model and URL
Check a device
Register a list of devices
Deregister a list of devices