Developers
Costruisci sopra Rankly
Tutto quello che ti serve per integrare la tua app con Rankly: REST API REST documentata OpenAPI 3, OIDC provider per il login utenti, API key Bearer per integrazioni machine-to-machine. Standard puri, niente librerie custom — qualunque client moderno funziona out-of-the-box.
REST API · OpenAPI 3
Spec OpenAPI 3 completo + Swagger UI interattivo. Endpoint pubblici (no auth) per leggere tornei/standings, endpoint autenticati per mutation. Versionato /api/v1.
Apri documentazione API →
Sign in with Rankly · OIDC
OAuth 2.0 + OpenID Connect provider. L'utente Rankly logga nella tua app, ottieni un access_token + id_token RS256 per chiamare l'API a nome suo (scope tournaments:read/write).
Quickstart OIDC →
Quale uso? API key o OAuth?
API key Bearer
Quando: integrazione server-to-server senza un utente specifico (job notturni, overlay caster, bot automatici che agiscono sull'org del cliente).
Come: emette una API key org-bound dalla dashboard dell'organizzazione, scope read/write. Header Authorization: Bearer rk_live_...
Sign in with Rankly (OIDC)
Quando: la tua app fa loggare gli utenti Rankly e poi agisce a nome loro (bot Discord che permette di iscriversi ai tornei, app mobile, dashboard di terze parti, integrazione SSO).
Come: registrazione client self-service dalla dashboard org (App OAuth dell'organizzazione), authorization code flow + PKCE, scope OIDC + custom tournaments:read/write. JWKS RS256 per verifica offline di id_token.
URL utili
- OpenAPI spec JSON: https://rankly.it/openapi.json
- OIDC discovery: https://api.rankly.it/api/auth/.well-known/openid-configuration ↗
- JWKS (RS256): https://api.rankly.it/api/auth/jwks ↗
- Tornei pubblici live (SSE):
GET /api/v1/public/tournaments/{id}/live/stream
Hai bisogno di una mano?
Scrivici a support@rankly.it per:
- chiarimenti su endpoint, errori di integrazione, edge case
- request di nuovi scope o feature API
- casi speciali (partner integration, multi-org, ecc.)
La registrazione standard di un client OAuth è self-service: se sei admin di un'organizzazione Rankly, vai su Account → Organizzazione → App OAuth, niente email.
Risposta email in italiano entro 1 giorno lavorativo (di solito molto prima).