Limites de frequência e IDs de pedido

60 pedidos por minuto por chave, Retry-After e X-Request-Id em cada resposta.

​

Limites de frequência

Cada credencial PMS pode fazer 60 pedidos por minuto. O limite é por chave, por isso duas chaves do seu PMS não o partilham.

GET /v1/health não precisa de chave, por isso o limite é por IP do cliente, também 60 por minuto.

Acima do limite, a Tatallo responde 429 com o código rate_limited e um cabeçalho Retry-After: o número de segundos até ao início do minuto seguinte. Aguarde esse tempo e continue.

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-Request-Id: c2b7e1d4-8a3f-4e6b-9d2c-7f1a5e9b3c08

{"error":{"code":"rate_limited","message":"Too many requests. Retry after the number of seconds in Retry-After.","request_id":"c2b7e1d4-8a3f-4e6b-9d2c-7f1a5e9b3c08"}}

Espacie uma sincronização completa de um portefólio grande com limit=100: um pedido devolve até 100 propriedades.

​

IDs de pedido

Cada resposta traz um cabeçalho X-Request-Id, erros e 429 incluídos. É sempre um UUID e o request_id de um erro tem o mesmo valor.

Para correlacionar pedidos de ponta a ponta, envie o seu UUID em X-Request-Id: a Tatallo devolve um UUID bem formado inalterado. Qualquer outro valor é substituído por um UUID gerado pela Tatallo, para o cabeçalho ser sempre analisado da mesma forma.

curl -s -i "$TATALLO_BASE_URL/v1/me" \
  -H "Authorization: Bearer $TATALLO_API_KEY" \
  -H "X-Request-Id: 2f1c6d3a-9b7e-4c55-8e21-0d4a6b9f7c13"

Cite o ID de pedido sempre que contactar o suporte.