# 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.