Errori e Risposte

Guida all'integrazione dell'app mobile

Codici di stato HTTP

200OK - richiesta riuscita.
204No Content - returned for OPTIONS preflight requests (CORS).
400Bad Request - parametro mancante o non valido.
401Unauthorized - token mancante o non valido.
404Not Found - endpoint o risorsa non esistente.
405Method Not Allowed - metodo HTTP errato per questo endpoint.

Schema risposta di successo

JSON
{
  "success": true,
  "...": "endpoint-specific fields"
}

Schema risposta di errore

JSON
{
  "success": false,
  "message": "Human-readable error description"
}

CORS

All API responses include the following headers, so the API can be called from web clients:

HTTP
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type, X-API-Token
*
Browsers send a preflight OPTIONS request before a cross-origin POST. The API responds with 204 No Content and the CORS headers above - no body required.