Piloterr

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.

Nesta página