Authentication & Headers
You authenticate to Pushbots API by providing Application ID in request headers.
|X-PUSHBOTS-APPID||Pushbots Application ID. *|
|X-PUSHBOTS-SECRET||Pushbots Application secret, should be used with Push API only.|
API calls are subject to rate limiting. Exceeding any rate limits will result in all endpoints returning a status code of 429 (Too Many Requests). Rate limits are per user per app.
Errors are returned using standard HTTP error code syntax. Any additional info is included in the body of the return call, JSON-formatted. Error codes not listed here are in the REST API methods listed below.
Standard API errors
|400||Bad input parameter/JSON. Error message should indicate which one and why e.g.
|401||Authentication headers are unauthorized. e.g.
|405||Request method not expected (generally should be GET or POST) e.g.
|409||Request could not be processed because of a missing parameter or a conflict. Error message should indicate which one and why e.g.
|429||Too Many Requests.|
|507||User is over API requests quota.|
|5xx||Pushbots Server error, check server status.|