Errori

Una sola forma di errore, sei codici stabili.

Ogni errore dell’API PMS Tatallo ha la stessa forma:

{
  "error": {
    "code": "property_not_found",
    "message": "Property not found.",
    "request_id": "385c1118-7082-4e15-97a7-16703f74d58b"
  }
}

Campo	Significato
code	Un codice stabile, in snake_case. Decidi in base a questo.
message	Una spiegazione in inglese, per chi legge, qualunque sia il tuo Accept-Language. Può cambiare in qualsiasi momento: non decidere mai in base a essa.
request_id	Lo stesso valore dell’header X-Request-Id della risposta. Citalo al supporto.

​

Codici

Stato	code	Significato	Che cosa fare
400	invalid_limit	limit non è un numero intero da 1 a 100.	Invia un limit da 1 a 100, oppure omettilo per il valore predefinito di 25.
400	invalid_cursor	cursor non è un cursore ricevuto da questa chiave: è stato modificato, costruito a mano, oppure emesso per un’altra chiave o un altro ambiente.	Ricomincia lo scorrimento senza cursore. Vedi Paginazione.
401	unauthorized	La chiave manca, è malformata, appartiene all’altro ambiente, è scaduta oppure è stata revocata.	Controlla la chiave e la base URL. Vedi Autenticazione.
403	insufficient_scope	La chiave è valida, ma non ha lo scope richiesto dalla route.	Chiedi una chiave con quello scope.
404	property_not_found	La proprietà non è collegata al tuo PMS, oppure non esiste. I due casi ricevono la stessa risposta.	Usa un id ottenuto da GET /v1/properties.
429	rate_limited	Troppe richieste in questo minuto.	Attendi i secondi indicati in Retry-After. Vedi Limiti di frequenza.

Dentro /v1 i codici non cambiano significato. Possono arrivare codici nuovi per situazioni nuove, quindi gestisci un codice sconosciuto in base al suo stato HTTP.