Teto geral
Há um teto de requisições por chave, por minuto. Ao estourar, a resposta é 429
com Retry-After em segundos — espere o que ele diz antes de tentar de novo.
O teto é por chave, não por IP: rodar sua integração de vários servidores não
multiplica o limite.
Teto de vídeo
A emissão de URL de mídia (/api/devices/{id}/media-url) tem um teto próprio,
bem menor que o geral.
O motivo é o custo, e vale entender: cada emissão acorda uma sessão de vídeo no
servidor de mídia. Isso não é uma linha de JSON — é CPU, e a capacidade é
contada em sessões simultâneas por servidor. Um laço de retry nessa rota não
degradaria a API: apagaria o vídeo da conta inteira.
Peça a URL quando for exibir, não em lote e não de forma preventiva. A URL
tem prazo próprio; guardá-la para depois não economiza chamada, só entrega um
endereço que já venceu.
Boas práticas de polling
O inventário e o diagnóstico mudam em minutos, não em segundos.
- Inventário: uma vez por hora cobre qualquer operação real.
- Diagnóstico: sob demanda, quando alguém for olhar — ele sonda a rede.
- Eventos: use a janela de tempo (
since) e avance a partir do último que
você já tem, em vez de reler o mesmo período.
