UNDER CONSTRUCTION
The Appoxee API allows you to access major parts of Appoxee back-end functionality, both from the Server side and from the Device side.
This document describes the Service API, which is mainly used to send Push notifications to devices (see Push Message API).
Other operations are performed through the SDK API (see Android SDK API Usage and iOS SDK API Usage).
All request data must be sent as an HTTP POST request in the JSON format (the data content type must be set to "applicaiton/json").
Appoxee API variables and parameters consist of case-sensitive keys (alpha-numeric value, starting with a letter) and their length should be under 100 characters. |
POST
'http://saas.appoxee.com/api/'
Name | Syntax | Description |
---|---|---|
? | ? | ? |
Contains the following arguments:
Parameter | Description | Syntax | |
---|---|---|---|
action | The action performed by this API. |
| |
signature | Appoxee's API security model ensures that every request has a unique secret signature. This signature is passed as a parameter inside the “auth” JSON object (along with additional authentication-related information). The signature is created using the MD5 hash function with the concatenation of the following parameters: Note that the parameter order is important! | Signature syntax in PHP format (for server-side usage): $signature = md5($auth['timestamp'] . SECRET . AppSDKKey . random); | |
| timestamp | The current time in seconds, in a Unix timestamp format. | 1330607184 |
| AppSDKKey | An Appoxee secret code that is unique per-app. | xxxxxxxxxxxxxx.xxxxxxxx |
| SECRET | An Appoxee secret code that is unique per-app, used by the Appoxee API to authenticate the app. |
xxxxxxxxxxxxxx.xxxxxxxx |
random | A security parameter that is unigue per-request, and ensures that no request is sent twice. Note: You can either use "random()" or "uniqid()". | 4f5cc37a93463 |
The API response has the following format:
HTTP Header Field | Value |
---|---|
Status Code |
|
Location? | The URL of the newly created object? |
The response body includes a description of the request result in JSON format.
The API call has one of the following results:
Response Result | Returns | Example |
---|---|---|
Success | A "Success" parameter | { "response": "Success" } |
Success with data retrieval |
| { "response": "Success", "result": [“tag1”, “tag2”] } |
Failure |
| { "response": "Error", "code": 0, "message": "Invalid request" } |
POST
???
???
200 OK
{
"response": "Success"
}