Reference

Everything you need to know before using Sandra's API.

Ratelimits

To keep things simple, a reasonable 10 requests per 10 seconds across all API calls is enforced. If you surpass this limit, you will be blocked from performing additional requests for one minute.

Responses

Each response from the API will always be valid JSON with application/json as the Content-Type. The only exception to this rule is Cloudflare landing pages. You may encounter such pages if Sandra is offline or you are being rate-limited.

Certain fields will always be present, such as status, success and version. Success denotes if the requested action was performed successfully or not. If the request was not successful, you can expect the message field as well.

{
    "status": 404, // Integer
    "success": false, // Boolean
    "version": "...", // String
    "message": "Not Found" // String
}