Authentication
Bearer, uniform 401, 403 sanctioned owner, rate limits, deprecated query token.
Every Hub /api/v1/* call requires:
Authorization: Bearer <your token>Generate the token in Manage → Settings. It is shown once. Regenerating invalidates the old one.
Uniform 401
Missing, malformed, unknown or invalid token: always 401 { "error": "invalid_token" }.
Owner 403
If the server owner is sanctioned from publishing: 403 { "error": "owner_sanctioned" }. The token is valid; the account is blocked.
Rate limits
Calls are limited per connection, then per authenticated route:
| Route | Cap / min |
|---|---|
| all (per connection) | 240 |
| check | 60 |
| claim | 30 |
| ranking | 120 |
Over the cap: 429 with Retry-After (seconds).
Deprecated query string
?server_token= is still accepted for legacy scripts — stop using it: a secret in the URL leaks. Put the token in Authorization. Cut-off: 2026-10-01.