Erros

Uma forma de erro, seis códigos estáveis.

Cada erro da API PMS Tatallo tem a mesma forma:

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

Campo	Significado
code	Um código estável em snake_case. Decida com base neste.
message	Explicação em inglês para pessoas, seja qual for o Accept-Language. Pode mudar a qualquer momento: nunca decida com base nela.
request_id	O mesmo valor que o cabeçalho X-Request-Id da resposta. Cite-o junto do suporte.

​

Códigos

Estado	code	Significado	O que fazer
400	invalid_limit	limit não é um número inteiro de 1 a 100.	Envie limit de 1 a 100, ou omita para o predefinido de 25.
400	invalid_cursor	cursor não é um cursor que esta chave recebeu: editado, construído à mão ou emitido para outra chave ou ambiente.	Recomece sem cursor. Veja Paginação.
401	unauthorized	A chave falta, está mal formada, é do outro ambiente, expirou ou foi revogada.	Verifique a chave e a base URL. Veja Autenticação.
403	insufficient_scope	A chave é válida mas não tem o âmbito que a rota precisa.	Peça uma chave com esse âmbito.
404	property_not_found	A propriedade não está ligada ao seu PMS ou não existe. Ambos recebem a mesma resposta.	Use um id de GET /v1/properties.
429	rate_limited	Demasiados pedidos neste minuto.	Aguarde Retry-After segundos. Veja Limites de frequência.

Os códigos nunca mudam de significado dentro de /v1. Podem ser adicionados códigos novos para situações novas; trate um código desconhecido pelo respetivo estado HTTP.