Cisco Unity Connection REST API FAQ
Links to Other API pages: Cisco_Unity_Connection_APIs
|CUPI Guide Contents|
|API Overview |
Index of All CUPI Documentation
What can cause a 415 error?
415 errors are generally caused by not specifying the requested content type. Try setting the "Content-Type" header to "application/xml".
What can cause a 503 error?
Because the CUPI API is designed for administrative tasks, it uses the same throttling as the Cisco Unity Connection Administration pages, which could lead to a 503 "Server busy" error.
By default, the maximum number of requests that can be processed at one time is three. All requests that come in while the three slots are in use are queued up. As soon as one request finishes processing, it releases a slot, which allows the first request in the queue to be processed. If a queued request wait time exceeds a timeout limit (20 seconds), then a 503 error is returned.
How do I GET the guid (objectid) of a user?
Search by alias to get the user XML, then extract the ObjectId field. For example, to find the user John Doe with alias jdoe:
GET http://<connection-server>/vmrest/users?query=(aliasis jdoe)
Note that some languages and/or libraries require the URL to be escaped first, in which case the spaces need to be converted to %20.
How do I find out which networked cluster a user is on?
Search for the user in the global user list, and look at the user's location (LocationObjectId):
GET http://<connection-server>/vmrest/globalusers?query=(aliasis jdoe)
What is returned from a PUT?
A successful PUT operation returns an HTTP status code of 204 No Content.
All HTTP 2xx status codes mean success. Status code 204 means (quoting from RFC 2616): "The server has fulfilled the request but does not need to return an entity-body (aka content)."
A PUT operation sends a request to the server to change/update a resource, so the server does not need to send back anything except a success code, which is what 204 is appropriate for.
Is there support for paging?
Yes. Paging is supported via two query parameters:
- rowsPerPage: Indicates how many objects to return in a single query.
- pageNumber: Indicates which page of objects to return.
GET http://<connection-server>/vmrest/users?rowsPerPage=100&page=1 GET http://<connection-server>/vmrest/users?rowsPerPage=100&page=2
What causes a 302 error?
An HTTP 302 response is very often caused by a client trying to connect to a web application by using HTTP protocol when the web application requires HTTPS. The web server sends back a 302 response to the client in an attempt to redirect it to the secure HTTPS port.