Errores

Una sola forma de error, seis códigos estables.

Todo error de la API PMS de Tatallo tiene la misma forma:

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

Campo	Significado
code	Un código estable, en snake_case. Decide según este valor.
message	Una explicación en inglés para personas, sea cual sea tu Accept-Language. Puede cambiar en cualquier momento: no decidas nunca en función de ella.
request_id	El mismo valor que la cabecera X-Request-Id de la respuesta. Cítalo a soporte.

​

Códigos

Estado	code	Significado	Qué hacer
400	invalid_limit	limit no es un número entero de 1 a 100.	Envía un limit de 1 a 100, o ninguno para el valor predeterminado de 25.
400	invalid_cursor	cursor no es un cursor que haya recibido esta clave: se editó, se construyó a mano o se emitió para otra clave u otro entorno.	Reinicia el recorrido sin cursor. Consulta Paginación.
401	unauthorized	La clave falta, está mal formada, es del otro entorno, ha caducado o está revocada.	Comprueba la clave y la URL base. Consulta Autenticación.
403	insufficient_scope	La clave es válida, pero no tiene el scope que exige la ruta.	Pide una clave con ese scope.
404	property_not_found	La propiedad no está conectada a tu PMS, o no existe. Ambos casos reciben la misma respuesta.	Usa un id de GET /v1/properties.
429	rate_limited	Demasiadas solicitudes en este minuto.	Espera los segundos de Retry-After. Consulta Límites de frecuencia.

Los códigos no cambian de significado dentro de /v1. Pueden añadirse códigos nuevos para situaciones nuevas, así que trata un código desconocido según su estado HTTP.