Erros seguem RFC 7807
Content-typeapplication/problem+json:
Por que 404 e não 403 para recurso de outra empresa
Um 403 confirmaria que aquele id existe em algum lugar. Repetido em sequência,
isso transforma a API num oráculo: dá para descobrir quais ids são reais sem ter
acesso a nenhum deles. Então recurso de outro tenant e recurso inexistente
respondem a mesma coisa — de propósito.
Paginação é por cursor
?cursor= para a próxima página. Quando next_cursor vier null,
acabou.
Não existe
offset de propósito. O worker cria lead continuamente: entre a página
1 e a página 2, leads novos entram no topo da ordenação e empurram o resto. Com
offset você reveria linhas já lidas e pularia outras — numa varredura de base
inteira, silenciosamente. O cursor é ancorado em (created_at, id) e não sofre
disso.limit: 200.
Idempotência
EmPOST /v1/sales, use external_source + external_id. Ver
Vendas.