Paginação e limites

As páginas são limitadas por quantidade e por bytes. Receber menos itens que o limite não encerra uma listagem; somente o cursor nulo encerra.

Formas de paginação

Família	Como continuar
Produtos, catálogos e estabelecimentos	Envie proximo_id como apos_id, preservando os filtros. Padrão 50, máximo 200.
Histórico de análises e vigilâncias	Envie proximo_cursor como cursor. Padrão 50, máximo 100.
Resultados de análise	Envie o número em proxima_pagina como pagina. Até 200 achados e limite de bytes.
Resultados de vigilância	Envie proximo_cursor como cursor. Até 200 achados e limite de bytes.
Eventos de webhook	Envie proximo_cursor como cursor. Padrão 50, máximo 100 e orçamento de 1 MiB por página.
Tentativas de webhook	Envie proxima_tentativa como apos_tentativa. Padrão 50, máximo 100.
Produtos selecionados	Envie proximo_id como apos_id e repita a versao da primeira página. Máximo 200.

O cursor é opaco e pertence à empresa e à família da consulta. Não o decodifique, altere ou reutilize em outra chave de paginação. Em resultados de vigilância, continue mesmo se uma página vier vazia com cursor.

Orçamento técnico

Fronteira	Teto atual
Todas as classes, por empresa e por chave	120 requisições admitidas por minuto em cada orçamento.
Leituras por empresa	120 por minuto, sujeitas ao teto conjunto.
Escritas de recursos	60 por minuto por empresa.
Operações que alteram ingestão	12 por minuto por empresa; consultar ingestão conta como leitura.
Testes e reenvios de webhook somados	5 por minuto por empresa.
JSON de recurso	128 KiB e até 5 segundos de leitura.
JSON de ingestão	256 KiB, até 200 produtos por lote e até 5 segundos de leitura.
Seleção de vigilância	16 KiB e até 200 inclusões e retiradas somadas.
Pedido de análise	2 KiB, com objeto vazio.
Configuração, teste ou revogação de webhook	4 KiB.

Criar várias chaves, alternar filiais ou rotacionar a credencial não aumenta o teto da empresa. Taxa técnica não é franquia paga de análise e não representa capacidade de vigilância.

O ingresso também aplica tetos compartilhados antes da autenticação: 2.400 requisições por minuto no conjunto, 600 por minuto pela origem observada no socket e 16 requisições simultâneas de recursos por processo. Esses valores protegem admissão; não são promessa de vazão sustentada.

Recuperar de recusa

429 e falhas temporárias podem trazer Retry-After. Aguarde, reduza paralelismo e preserve a Idempotency-Key de qualquer escrita já enviada. Se o contador estiver indisponível, a API recusa a operação com 503; ela não prossegue sem conseguir comprovar o orçamento.