API v1 / schema 1.0.0

Erros e limites da API da taxa turística

Lidar com falhas sem alterar impostos.

Uso de erros {"error":{"code":"…","message":"…"}}. Leia primeiro o status HTTP. Nunca substitua as configurações salvas da taxa turística para uma acomodação após uma solicitação malsucedida.

Status Ação
400 Corrija as entradas da solicitação.
401 Verifique se uma chave ativa válida foi fornecida.
403 Verifique os escopos da chave e os países permitidos.
422 O escopo excede o limite revisado. Inspecione uma jurisdição mais restrita.
429 Respeite o atraso de nova tentativa; use retrocesso limitado.
503 Os dados ou o serviço estão indisponíveis. Mantenha as configurações existentes e tente novamente mais tarde.

As chaves têm por padrão 300 requisições por minuto, a menos que o operador provisionar um limite diferente. O proxy anónimo do website tem limites separados e mais restritos. Não o utilize como sua API de integração de produção.

Defina um tempo limite limitado, evite registrar chaves ou endereços e não tente novamente falhas de validação ou autenticação indefinidamente.