Quais são os limites de taxa?

Atualmente, não aplicamos limites estritos de requisições por segundo. No entanto, espera-se um uso responsável para manter a qualidade do serviço para todos.

Abordagem atual

Em vez de limites rígidos, incentivamos o uso responsável:

• Espaçe suas requisições de forma razoável

• Implemente backoff exponencial quando ocorrerem erros

• Armazene em cache as respostas para evitar chamadas redundantes

• Entre em contato conosco se você antecipar volumes altos de tráfego

Boas práticas

Faça cache de forma agressiva:

• Armazene os resultados de busca para consultas comuns

• Mantenha os metadados de mídia localmente após a recuperação

• Não chame /confirm várias vezes para o mesmo usuário/recurso

Faça o agrupamento das operações:

• Junte requisições relacionadas

• Adicione pequenos atrasos entre os lotes

• Limite conexões simultâneas (10-20 é razoável)

Trate os erros com elegância:

• Implemente lógica de nova tentativa com backoff exponencial

• Não tente novamente imediatamente em caso de falha

• Registre erros para monitoramento

Tempos de resposta esperados

• busca em /resources: tipicamente 200-500ms

• detalhes de /resource: abaixo de 100ms

• licenciamento em /confirm: 300-800ms

Defina o timeout do seu cliente para pelo menos 30 segundos para lidar com respostas ocasionalmente mais lentas.

Se você atingir os limites

Você receberá um erro 429 Too Many Requests. Quando isso acontecer:

// Implementar backoff exponencial
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      
      if (response.status === 429) {
        const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s
        await new Promise(resolve => setTimeout(resolve, waitTime));
        continue;
      }
      
      return response;
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

Monitore seu uso

Acompanhe a atividade da API em Configurações → API:

• Veja o total de requisições feitas

• Verifique licenças ativas

• Analise tendências de uso

• Monitore padrões incomuns

Precisa de limites mais altos?

Se o seu caso de uso legítimo exigir volumes altos de requisições (>1M requisições/mês), entre em contato com nossa equipe para discutir:

• Seu aplicativo e padrões de tráfego

• Volume esperado de requisições

• Limites de taxa garantidos, se necessário