Existing Services
...
General URL structure
Common prefix:
| Panel | |||||
|---|---|---|---|---|---|
|
Note: how to see inside the SSL with Wireshark is described here SipX_ConfigServer_Troubleshooting#Using_Wireshark_to_see_inside_the_box
Testing the services
Here is an example of how to print the content of a phonebook named sales to stdout in CSV format
| Panel |
|---|
curl --insecure --basic -u superadmin [https://]{host}:8443/sipxconfig/rest/phonebook/sales |
...
To test the call placing service with curl use:
| Panel |
|---|
curl --insecure -X PUT [https://]{user}:{password}@{host}:8443/sipxconfig/rest/call/{number} |
HTTP PUT to service URL will cause sipXconfig to place call to {number}.
The calls is placed using authorized user credentials. It works in the same way as click-to-call available on the user portal. User's phone rings first and, once someone answers, it places the call to {number}.
Version|4.2
New Services
General URL structure
Common prefix:
...
| nopanel | true |
|---|
...
.
...
Note: how to see inside the SSL with Wireshark is described here SipX_ConfigServer_Troubleshooting#Using_Wireshark_to_see_inside_the_box
Admin services
Accessible for users with admin priviledgesprivileges:
URI | Methods |
|---|
...
Formats |
|---|
/phonebook |
...
GET | Returns a list with all the phonebooks. XML: {{<?xml version="1.0" encoding="UTF-8"?> | |
/phonebook/{name} |
...
GET | Returns a list with {name} phonebook entries. CSV | |
/phone | POST | Creates a phone. XML |
/auto-attendant | GET | |
/auto-attendant/specialmode |
...
GET | GET retrieves the use the special auto attendant status(true/false). PUT will set it to true, DELETE will set it to false. XML, JSON | |
/auto-attendant |
...
/{attendant} |
...
/special | PUT | PUT - Use the attendant as special attendant; DELETE - TBD |
User services
Accessible for all users:
URI | Methods | Formats |
|---|---|---|
/my/call/{to} | PUT | Initiates the call from the user to {to} address.PUT method requires non empty body which is ignored.Supported as GET for clients that do not handle PUT. |
/my/voicemail/pin/{pin} | PUT | changes user voicemail PIN |
/my/forward | GET | retrieves (GET) or changes (PUT) user call forwardingXML,JSON |
/my/feed/voicemail/{folder} | GET | voicemail folder presented as RSS feed |
/my/phonebook | GET | JSON, XMLphonebook representation |
/my/phonebook/entry/{entryId} | GET | retrieves (GET), changes (PUT) and deletes (DELETE) entries in private phonebookXMLJSON |
/my/contact-information | GET | |
/my/search/phonebook?query={search-term} | GET | searching user phonebookXML |
/my/mailbox/{user}/preferences/activegreeting | GET | retrieves and sets active greeting setting for a specific user |
Adding new Services
sipXconfig used the RESTlet API to add RESTful services
| Panel |
|---|
Please note, due to a bug in RESTlet, it requires HTTP PUT request must have a body. You can add space, or anything to the body
to workaround it.
Service design
- Identify resouces and design the resource structure
- Determine which operations (GET, PUT, POST, DELETE) will be available for which resources
- Map resources into URI structure
- Determine representation for each resource (specific format XML/JSON)
Service implementation
- Implement resources
- :Each resource is an instance of restlet Resource class. Every RESTful function is mapped into one or more Resource methods. For example GET method is implemented by Resource.represent
- :Resource instances are managed by Spring. You can inject any context or manager that is necessary to perform service operations. For example phonebook service delegates bulk of the work to PhonebookManager.
...
...
- Implement representations
- :sipXconfig services intended to be used pragmatically should at the minimum support XML and JSON representations. Read-only services marshal sipXconfig domain objects into representation.
- Write service system tests
- :Those are external tests written in Java/Ruby/Python that excersise the service. They are similar to UI tests.
Future Services
User ('my') services (those are services needed to implement functionality available through current user portal)
...
If you are thinking about implementing an external application interacting with sipXecs and you need a new service ask on the sipx-dev list.