Introduzione alle API MyCentralino

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

Base URL

https://api.mycentralino.com

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

X-API-KEY: sk_mycentralino_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

I limiti sono applicati per account, non per singola chiave API:

Limite	Default
Richieste/minuto	20
Richieste/giorno	1000

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

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.

Tutte le risposte sono in formato JSON con struttura:

{
  "success": true,
  "data": { ... }
}

In caso di errore:

{
  "success": false,
  "error": "Descrizione errore"
}