> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scaleflow.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Erreurs et limites

> Codes de réponse, limites de débit et de taille, et bonnes pratiques pour ne perdre aucun lead.

## Lire une réponse

| Code | Signification | Que faire |
| - | - | - |
| `200` | Reçu et enregistré | Lire `warnings` : un champ a pu être ignoré ou un placement retombé au défaut |
| `400` | Requête invalide | Corriger le corps ou l'URL. Ne pas réessayer tel quel |
| `401` | Jeton refusé | Vérifier le jeton, ou le regénérer dans **Réglages → Tags & Webhook** |
| `404` | Endpoint ou pipeline introuvable | Vérifier l'`endpoint_id` et le nom du pipeline |
| `409` | Ambiguïté | Préciser par identifiant (`pipeline_id`) |
| `422` | Configuration manquante dans l'espace | Créer l'élément manquant dans ScaleFlow (ex. un pipeline de recrutement) |
| `429` | Trop de requêtes | Attendre le délai indiqué par l'en-tête `Retry-After`, puis réessayer |
| `500` | Erreur côté ScaleFlow | Réessayer plus tard |

Le format exact du corps d'erreur est donné sur la page de chaque webhook.

## Limites

| Limite | Valeur |
| - | - |
| Débit | 120 requêtes par minute et par adresse IP, tous webhooks confondus |
| Taille du corps | 1 Mio par requête |
| `answers` (recrutement) | 50 questions maximum, 100 caractères par question, 2 000 caractères par réponse, 32 Kio au total, 5 niveaux d'imbrication |

Un dépassement de `answers` est refusé en `400`, avec un message qui nomme la limite et la question en cause : rien n'est tronqué en silence.

## Bonnes pratiques

<AccordionGroup>
  <Accordion title="Réessayer sur 429 et 500, pas sur 4xx">
    Un `429` ou un `500` est temporaire : réessayez avec un délai croissant. Une erreur `400`, `401`, `404`, `409` ou `422` ne se résoudra pas toute seule : corrigez la requête ou la configuration avant de renvoyer.
  </Accordion>

  <Accordion title="Réessayer sans crainte de doublon">
    Un lead renvoyé avec le même e-mail ou le même téléphone est rattaché à la fiche existante. Une candidature renvoyée avec le même e-mail dans le même pipeline aussi. Un nouvel essai ne crée donc pas de doublon.
  </Accordion>

  <Accordion title="Garder le jeton secret">
    Stockez le jeton dans les secrets de votre outil, jamais dans le code d'une page web : il serait lisible par n'importe quel visiteur. En cas de doute, regénérez-le.
  </Accordion>

  <Accordion title="Surveiller warnings pendant les tests">
    Un nom de pipeline, d'étape ou un identifiant de tag mal saisi ne fait pas échouer l'envoi du lead : il est signalé dans `warnings`. Vérifiez ce champ sur vos premiers envois.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.