Référence du Point de Terminaison

Initialisation de lot

Enregistrez des candidats pour un poste en soumettant des URLs de documents signées (PDF, DOCX, TXT). Chaque CV est téléchargé, analysé, validé puis stocké dans AWS S3 et DynamoDB. Les envois de fichiers multipart ne sont pas pris en charge.

POST/v1/batch/init

Paramètres de Requête

Nom	Type	Description
job_idRequis	string	L'identifiant texte du poste cible.
language	string	Langue optionnelle du document.
candidatesRequis	array(object)	Tableau d'objets candidat, chacun avec une document_url signée (de 1 à 25).
candidates[].document_urlRequis	string	URL HTTPS signée permettant de télécharger le CV (PDF, DOCX, TXT).
candidates[].name	string	Nom d'affichage du candidat (optionnel).
candidates[].external_candidate_id	string	Votre propre identifiant de candidat. Nous le stockons et le renvoyons tel quel (optionnel).

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/init" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "YOUR_JOB_ID",
    "language": "en",
    "candidates": [
      {
        "name": "Jane Doe",
        "external_candidate_id": "ATS-0042",
        "document_url": "https://s3.amazonaws.com/bucket/resume1.pdf"
      },
      {
        "document_url": "https://s3.amazonaws.com/bucket/resume2.pdf"
      }
    ]
  }'