Base URL
Authentication
All endpoints require a Firebase ID token unless marked[PUBLIC] or [DEV_KEY].
API
API Contract
Base URL, authentication, response format, and error codes
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Base URL, authentication, response format, and error codes
https://api.susaplay.com
[PUBLIC] or [DEV_KEY].
Authorization: Bearer {firebase_id_token}
Authorization: ApiKey {developer_api_key}
Authorization: PartnerKey {partner_key}
{
"success": true,
"data": { }
}
{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Human-readable description"
}
}
| Code | HTTP | Meaning |
|---|---|---|
UNAUTHENTICATED | 401 | Missing or invalid token |
UNAUTHORIZED | 403 | Authenticated but not permitted |
NOT_FOUND | 404 | Resource does not exist |
INVALID_ARGUMENT | 400 | Missing or malformed request body |
INSUFFICIENT_BALANCE | 400 | Not enough currency to complete spend |
DUPLICATE_PURCHASE | 400 | Receipt already validated |
INVALID_RECEIPT | 400 | Apple/Google rejected the receipt |
GAME_NOT_FOUND | 404 | Game key does not match any active game |
VERSION_CONFLICT | 409 | Cloud save version mismatch |
DUPLICATE | 409 | Build version id already exists |
FAILED_PRECONDITION | 409 | Too many builds already waiting for review |
RATE_LIMITED | 429 | Too many requests |
INTERNAL | 500 | Unexpected server error |