Skip to content
CurriculoCurriculo ATS DocumentationDocs
API referenceConsole

Les erreurs

On this page

Les erreurs sont JSON et portent le statut de HTTP qui compte. Rien n'échoue en silence: une demande rejetée vous explique pourquoi. Chaque réponse porte un en-tête X-Curriculo-Request-Id . Citez-le lorsque vous nous contactez.

Format d'erreur

Retour de refus à la limite (authentification, crédit, limite de taux, demande surdimensionnée):

{"success": false, "error": "...", "message": "..."}

Erreurs survenues lors du traitement de la déclaration:

{"detail": "..."}

Dans une demande de liste, un élément raté porte sa propre erreur à l'intérieur de resultset l'état HTTP de la demande reste 200. Voir Batchage.

Codes d'état HTTP

Le statutLa significationCe qu'il faut faire
400L'entrée est inutilisable: fichier vide, texte vide, document illisible ou protégé par mot de passe, job_detailsmalformé, clé JSON dupliquée. Pour une tâche d'enregistrement, pas assez de crédit pour réserver le maximum de 2 heures.Réparer la charge utile, ou ajouter du crédit. La réessayer des octets identiques échouera de la même manière.
401"Token API manquant...", "Token API invalide." (clés inconnus ou révoqués), "Token API expiré.", ou "Endpoint API inconnu" pour un chemin sous /public/ qui n'existe pas.Vérifiez l'en-tête Authorization , la clé et le chemin.
403La clé est valide mais le compte ne peut pas servir le trafic: aucun crédit prépayé ("...Acquérir des crédits dans la console."), le compte est suspendu, ou "L'approvisionnement du compte est incomplet".Ajoutez le crédit dans Console → facturation, ou attendez que le stockage soit terminé. Si le compte est suspendu, contactez-nous.
404job_idinconnu , ou un enregistré par un compte différent. Il y a aussi un identifiant de tâche inconnu ou un chemin à l'extérieur. /public/.Enregistrez l'emploi à nouveau; les identifiants sont visés par l'identité qui les a créés. Vérifiez la base URL.
413Au-dessus d'un plafond de taille: corps de demande, document, enregistrement, longueur de lot ou nombre de caractères.Divisez la charge de travail ou envoyez des enregistrements par lien. Voir les limites de taille des demandes .
422La validation du schéma a échoué: un champ requis est manquant ou mal nommé. Une langue de traduction en dehors des 85 codes pris en charge.Comparer avec le OpenAPI spécification. Les noms de champs sont sensibles aux cas. Voir Langues.
429La limite de tarification a été dépassée.Retirez-vous et réessayez. L'honneur Retry-After en présence.
500Notre échec.Essayez encore une fois. Si elle persiste, contactez-nous avec le X-Curriculo-Request-Id.
503Une dépendance n'est pas disponible ou une fonctionnalité n'est pas activée ici (par exemple, la transcription des médias).Essayez à nouveau avec Backoff.
504Le traitement a dépassé le plafond de 300 secondes.Envoyer moins d'articles ou un document plus petit, ou utiliser la voie d'asynchronisation .

Les demandes ratées ne sont jamais facturées. Un 4xx ou un 5xx ne vous coûte rien, ni une tâche d'arrière-plan ratée.

Retour à l'orientation

  • Ne réessayez pas 400,401,403,404,413 ou 422 inchangés. Réparer la demande d'abord.
  • Réessayez avec le backoff sur 429 et 503.
  • Essayez à nouveau une fois activé. 500.
  • Sur 504, renvoie avec moins d' articles ou un document plus petit. Dans une demande de liste, renvoyer uniquement les éléments qui ont renvoyé une entrée 504 .
  • Envoyer un seul document échoué est toujours sûr. Il ne peut pas créer de copies ou d'enregistrements semi-finis.

Contacts

Écrivez à [email protected] avec l'heure, l'opération et le X-Curriculo-Request-Id.

Updated