Boas Práticas

Para garantir uma integração estável e eficiente com a API da Oystr, tanto em Lotes ou Itens, recomendamos observar as seguintes boas práticas:

• Frequência de envio de requisições
  Evite o envio excessivo de chamadas em curtos períodos de tempo. Altas taxas de requisição podem gerar sobrecarga, aumento de filas internas e impactar o tempo de processamento dos robôs. Isso também poderá acarretar em problemas de bloqueios externos e autenticação/identidade com os sistemas envolvidos.
  
• Frequência de consulta de resultados (polling)
  As consultas de resultados devem respeitar os intervalos recomendados. Polling muito frequente pode causar consumo desnecessário de recursos e degradação de performance. Para consulta de resultados recomendamos intervalos entre 30 e 120 segundos.
  
  
• Consulta de dados antigos
  Resultados de execuções ficam disponíveis para consulta por um período limitado. Atualmente, a Oystr mantém os dados disponíveis por até 7 dias. Após esse período, os dados podem não estar mais acessíveis.
  
  
• Validação de credenciais antes da execução
  Evite executar robôs com credenciais potencialmente inválidas ou expiradas. Esse tipo de execução consome recursos desnecessários (como captcha, proxy e processamento) e pode impactar negativamente o desempenho geral da operação.
  
  
• Evitar execuções duplicadas em curto intervalo
  Não execute o mesmo robô com os mesmos parâmetros repetidamente em um curto espaço de tempo. Isso pode gerar consumo desnecessário de recursos e aumentar o risco de bloqueios externos (ex: sistemas de terceiros). Sempre que possível, utilize mecanismos de controle como cid para evitar duplicidade.
  
  
• Registro de requisições e respostas (logging)
  Recomendamos armazenar as requisições enviadas e as respostas recebidas (incluindo IDs de execução) em logs ou arquivos persistentes. Isso é fundamental para rastreabilidade, auditoria e investigação de possíveis problemas em ambiente de produção.