HTTP Status Codes
| Status | Used for |
|---|---|
200 OK |
Successful read (GET /likee/user/*, GET /orders/*) and duplicate recharge replays |
201 Created |
New recharge order accepted |
400 Bad Request |
Invalid JSON body |
401 Unauthorized |
Missing or invalid API key |
402 Payment Required |
Insufficient API key balance |
403 Forbidden |
Key/store disabled, platform not enabled, IP not allowed |
404 Not Found |
Likee user or order not found, unknown endpoint |
405 Method Not Allowed |
Wrong HTTP method |
409 Conflict |
Reserved for conflicts (duplicate replays currently return 200 with duplicate: true) |
422 Unprocessable Entity |
Validation failures (Likee ID, UID mismatch, diamond, amount, request_id) |
429 Too Many Requests |
Rate limit exceeded — see X-RateLimit-Reset |
500 Internal Server Error |
Unexpected error (retry later) |
503 Service Unavailable |
Upstream Likee service temporarily unavailable (retry with backoff) |
Always inspect error.code in the JSON body rather than relying on the HTTP status alone.