Délais d'attente

La plupart des requêtes répondent en quelques secondes, mais certains endpoints peuvent prendre plus de temps. Cette page explique notre limite côté serveur et comment éviter que votre client ne coupe la connexion avant notre réponse.

Limite côté serveur : 60 secondes

Tous les appels d'API en temps réel ont un timeout strict de 60 secondes côté serveur. Les réponses typiques sont renvoyées en 2 à 3 secondes, parfois jusqu'à 30 secondes, et la limite avant interruption est de 60 secondes.

Pourquoi votre requête semble timeout plus tôt

Si vous observez systématiquement des timeouts à exactement 15s, 30s ou toute autre valeur inférieure à 60 secondes, la connexion est presque toujours coupée par votre propre infrastructure, pas par notre API. Votre runtime annule la requête HTTP avant qu'on ait le temps de répondre.

Signes courants:

• Les erreurs surviennent à la même durée exacte à chaque essai (souvent 10s, 15s, 25s, 30s).
• Notre dashboard indique la requête comme 200 (succès) alors que votre client signale un timeout.
• Les requêtes plus petites ou cachées passent, mais les plus lourdes échouent toujours.

Timeouts à vérifier selon votre plateforme

Voici les timeouts HTTP / fonction par défaut des plateformes les plus courantes. Augmentez-les à au moins 60 secondes pour correspondre à notre limite côté serveur.

// app/api/my-route/route.ts (Next.js App Router sur Vercel)
export const maxDuration = 60

export async function POST(req: Request) {
  // ... appel à notre API
}

{
  "functions": {
    "app/api/**/*.ts": { "maxDuration": 60 }
  }
}

# AWS CLI
aws lambda update-function-configuration \
  --function-name my-function \
  --timeout 60

# netlify.toml
[functions]
  timeout = 26

const res = await fetch("https://api.example.com/...", {
  signal: AbortSignal.timeout(60_000),
})

// fetch Node.js avec AbortController
const controller = new AbortController()
const timer = setTimeout(() => controller.abort(), 60_000)
try {
  const res = await fetch(url, { signal: controller.signal })
} finally {
  clearTimeout(timer)
}

# requests Python
import requests
requests.get(url, timeout=60)

# curl
curl --max-time 60 ...

Toujours des timeouts ?

Si votre client est configuré pour au moins 60 secondes, que le mode asynchrone ne convient pas à votre cas et que vous voyez encore des timeouts, ouvrez un ticket de support depuis votre dashboard avec : l'endpoint, un request_id d'exemple, le timestamp, et la valeur de timeout observée. Nous regarderons.

Voir Paramètres globaux pour is_async et soft_fail, Codes de statut pour les codes de réponse, et Bonnes pratiques pour les stratégies de retry.