Tempos limite
Como a Piloterr lida com pedidos longos, e como configurar o tempo limite no seu cliente.
A maioria dos pedidos responde em poucos segundos, mas alguns endpoints podem demorar mais. Esta página explica o nosso limite no servidor e como evitar que o seu cliente desista antes de respondermos.
Limite no servidor: 60 segundos
Todas as chamadas de API em tempo real têm um timeout rígido de 60 segundos do nosso lado. As respostas típicas são retornadas em 2 a 3 segundos, ocasionalmente até 30 segundos, e o pior caso antes de abortarmos é 60 segundos.
Se precisa executar requisições que podem demorar mais de 60 segundos, mude para o modo assíncrono com is_async=true. Veja Parâmetros globais.
Porque o seu pedido parece expirar antes
Se observa timeouts consistentes em exatamente 15s, 30s ou qualquer valor abaixo de 60 segundos, a conexão está quase sempre a ser fechada pela sua própria infraestrutura, não pela nossa API. O seu runtime aborta a chamada HTTP antes que possamos responder.
Sinais comuns:
- Os erros ocorrem na mesma duração exata em cada tentativa (frequentemente 10s, 15s, 25s, 30s).
- O nosso painel mostra o pedido como
200(sucesso) enquanto seu cliente reporta um tempo limite. - Requisições menores ou em cache funcionam, mas as mais pesadas sempre falham.
Tempos limite a verificar conforme a sua plataforma
Abaixo os timeouts HTTP / função padrão das plataformas mais comuns. Aumente-os para pelo menos 60 segundos para corresponder ao o nosso limite no servidor.
Vercel Serverless e Edge Functions têm timeout padrão de 15s no plano Hobby (até 60s) e 15s no Pro (até 300s, configurável por função).
Defina maxDuration na sua rota ou função:
// app/api/my-route/route.ts (Next.js App Router na Vercel)
export const maxDuration = 60
export async function POST(req: Request) {
// ... chamada da nossa API
}Ou em vercel.json:
{
"functions": {
"app/api/**/*.ts": { "maxDuration": 60 }
}
}Referência: Vercel function duration.
Ainda vendo timeouts?
Se o seu cliente está configurado para pelo menos 60 segundos, o modo assíncrono não se encaixa no seu caso, e ainda vê tempos limite, abra um ticket de suporte pelo seu painel com: o endpoint, um request_id de exemplo, o carimbo de data/hora e o valor de tempo limite observado. Vamos investigar.
Veja Parâmetros globais para is_async e soft_fail, Códigos de estado para códigos de resposta, e Melhores práticas para orientação de retry.