Référence du Point de Terminaison

Batch JSON

Soumettez jusqu'à 500 CV pré-analysés sous forme d'objets JSON en une seule requête. Chaque entrée peut inclure un external_candidate_id optionnel — votre propre référence opaque (ID ATS, user_id, etc.) que nous stockons et renvoyons dans tous les résultats.

POST/v1/batch-json

Paramètres de Requête

Nom	Type	Description
job_idRequis	string	Un job_id valide obtenu via POST /v1/create-job ou POST /v1/parse-job.
language	string	Code langue pour l'analyse IA (ex: 'en', 'fr', 'es'). Par défaut: 'en'.
candidatesRequis	array	Tableau d'objets candidats (1–500). Chaque élément contient un 'resume' (JSON ParsedResume) et un 'external_candidate_id' optionnel (chaîne, max 255 caractères).

Astuce Pro

Gérez toujours les en-têtes de limitation de débit dans votre logique. Pour de meilleures performances, utilisez le traitement asynchrone pour les fichiers volumineux.

curl -X POST https://api.evalcv.com/v1/batch-json \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "YOUR_JOB_ID",
    "language": "en",
    "candidates": [
      {
        "external_candidate_id": "ATS-EMP-0042",
        "resume": {
          "name": "Jane Doe",
          "email": "jane@example.com",
          "skills": ["Python", "FastAPI"],
          "experience": [],
          "education": []
        }
      }
    ]
  }'