The SympoQ's Application programming interface (API) is a RESTful web service. It allows performing RESTful operations like request's submission, adding updates to a ticket, listing users (named agents and customers), listing various setting's items, etc. Based on the API description, you can build web, mobile, or server applications that can access your SympoQ data and services.
SympoQ APIs are plain JSON over HTTP and use the following HTTP commands:
|Create an object
|Fetch one or more objects
|Update an object
|Delete an object
The URIs used by the API have a common base URI followed by the response data format. The base URI contains the following parts:
- HTTPS protocol specified
- API server hostname, which is your account name
- API keywords
Before you can use any of the RESTful operations, you need to authenticate yourself using your personal API key. The API key must be sent as the request's Header key apikey.
For example, if the API key is
dWIeGMRlikMIle, then the corresponding curl command is:
curl -X GET \
-H 'apikey: dWIeGMRlikMIle'
You can find your API key in the My profile page:
- Log in to your SympoQ account
- Click the My Profile link
- Your API key will be available at the bottom of the profile page.
The ability to access data depends on the permissions available to your SympoQ user profile. For example, if your support role is "Agent" in a ticket Queue, then you can access only assigned tickets from the Queue.
API requests that result in errors return an appropriate HTTP status code. Please use the following table for the reference.
|The Request was successful. For a GET request, the response contains an entity corresponding to the requested resource. In a POST request the response will contain an entity describing or containing the result of the action.
|Returned only for POST requests that create repository items. The request was successful and the repository item was created.
|The request could not be completed because the request URL and/or parameters were improperly formatted.
|Client session does not have the proper security credentials to execute the method, property, or access the repository for the requested resource.
|The specified property has been configured as not writable via the filtering configuration.
|The request could not be completed because it was made for a resource which does not exist.
|Returned only for DELETE requests that remove repository items. The request was successful and the repository item was deleted.
|Internal server error
|The request could not be completed because an unexpected exception occurred.
The API server limits the number of requests that can be sent during an interval of time with different limits for read and write operations.