Skip to main content

​
Introduzione alle API MyCentralino

Le API di MyCentralino permettono di integrare le funzionalità del centralino nelle tue applicazioni.

​
Base URL

https://api.mycentralino.com

​
Autenticazione

Tutte le richieste (eccetto /test e /v1/ping) richiedono una API key nell’header X-API-KEY. 
X-API-KEY: sk_mycentralino_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Rate Limiting

I limiti sono applicati per account, non per singola chiave API:
LimiteDefault
Richieste/minuto20
Richieste/giorno1000

​
Headers di risposta

Ogni risposta include headers informativi: 
X-RateLimit-Limit-Minute: 20
X-RateLimit-Remaining-Minute: 19
X-RateLimit-Limit-Day: 1000
X-RateLimit-Remaining-Day: 999

​
Errore 429

Se superi i limiti, riceverai: 
{
  "success": false,
  "error": {
    "code": "minute_limit_exceeded",
    "message": "Troppe richieste. Riprova tra 45 secondi."
  }
}
L’header Retry-After indica i secondi di attesa.

​
Formato Risposte

Tutte le risposte sono in formato JSON con struttura: 
{
  "success": true,
  "data": { ... }
}
In caso di errore: 
{
  "success": false,
  "error": "Descrizione errore"
}

​
Codici HTTP

CodiceSignificato
200Successo
400Richiesta non valida
401API key mancante o non valida
404Risorsa non trovata
429Rate limit superato
500Errore interno