Referencia de Endpoint

Inicialización de lote

Name: EvalCV API
Rating: 4.9 (120 reviews)

Registre candidatos para un puesto enviando URLs de documento firmadas (PDF, DOCX, TXT). Cada CV se descarga, analiza, valida y almacena en AWS S3 y DynamoDB. No se admite la subida de archivos multipart.

POST/v1/batch/init

Parámetros de Solicitud

Nombre	Tipo	Descripción
job_idRequerido	string	El identificador de texto del puesto de destino.
language	string	Idioma opcional del documento.
candidatesRequerido	array(object)	Matriz de objetos candidato, cada uno con una document_url firmada (de 1 a 25).
candidates[].document_urlRequerido	string	URL HTTPS firmada para descargar el CV (PDF, DOCX, TXT).
candidates[].name	string	Nombre visible del candidato (opcional).
candidates[].external_candidate_id	string	Su propio identificador de candidato. Lo almacenamos y se lo devolvemos igual (opcional).

Consejo Pro

Maneje siempre los encabezados de límite de velocidad en su lógica. Para un mejor rendimiento, utilice el procesamiento asíncrono para archivos grandes.

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"
      }
    ]
  }'