The Grievance App API is implemented as (somewhat) simple XML or JSON over HTTP. For now, only grievance creation is supported, but eventually, all resources inside Grievance App will be accessible and modifiable via the API.
Authentication #
Authentication via the API is done via API keys configured inside the Grievance App admin panel. API keys are created and tied to a source IP address, which will be checked against the source IP of requests to the HTTP API.
API keys can be created and managed via the admin panel. Navigate to Manage -> API keys. Use Add New API Key to create a new API key. Currently, no special configuration is required to allow the API key to be used for the HTTP API. All API keys are valid for the HTTP API.
HTTP Access #
Access to the HTTP API is restricted to valid API keys. An X-API-Key HTTP header must be sent to indicate which API key is to be used with the request. The API key must match the remote IP of the connected HTTP client. The remote IP is checked as usual. If the Grievance App server is sitting behind a reverse proxy, the original IP of the client will be retrieved from the X-Forwarded-For header, if provided by your proxy.
Example:
X-API-Key: BA00B76BAA30F62E1940B46CC1C3C73C
Commandline Example with Curl:
curl -d "{}" -H "X-API-Key: BA00B76BAA30F62E1940B46CC1C3C73C"
https://support.you.tld/api/tickets.json
Wrappers #
Currently, there are no wrappers for the API. If you’ve written one and would like it on the list, submit a pull request to add your wrapper.