Melhores Práticas

• Gerenciamento Seguro de Credenciais: Armazene seu clientSecret e x-api-key de forma segura. Nunca os exponha no código do lado do cliente. Tokens de acesso (JWTs) também devem ser tratados com cuidado.
• Use Especificidade Sempre que Possível: Se você souber o tipo do documento, fornecer docsType pode levar a um processamento mais rápido e preciso.
• Otimize Imagens: Para documentos de imagem, garanta que estejam nítidos, bem iluminados e com resolução suficiente. Evite tamanhos de arquivo excessivamente grandes, se possível, sem sacrificar a legibilidade.
• Lide com Tentativas (Retries): Implemente um mecanismo de nova tentativa com recuo exponencial (exponential backoff) para problemas de rede transitórios ou erros de servidor 5xx.
• URLs de Documentos Seguras: Se os documentos contiverem informações sensíveis, garanta que docsURL aponte para um local seguro (HTTPS). Considere usar URLs assinadas ou outros mecanismos de acesso temporário se o seu provedor de armazenamento os suportar.
• Valide as Entradas: Valide os dados do seu lado antes de enviá-los para a API para capturar erros antecipadamente.
• Monitore o Uso da API: Fique de olho no volume de chamadas da API e nos tempos de resposta.