API descripción general
On this page
El Curriculo API es un API RESTful en https://api.curriculo.me/public que brinda acceso programático a los mismos motores de currículum, evaluación, idioma y entrevista que se ejecutan dentro del producto Curriculo. Las solicitudes son JSON o multipart/form-data; las respuestas son JSON.
¿Nuevo en Curriculo? Comience con la Guía de inicio rápido : cree una cuenta, genere una clave y realice una llamada.
Requisitos
- Una cuenta Developer Console
- Una clave API creada en Console → API claves
APIs disponibles
| API | Operación | Qué hace | Precio |
|---|---|---|---|
| Analizar | POST /parse/ | Leer CVs (PDF o DOCX) en JSON estructurado. | $0.01 por solicitud |
| Evaluar | POST /evaluate/ | Evaluar CVs respecto a una oferta: idoneidad, análisis de ajuste, brechas. | $0.01 por solicitud |
| Empleos | POST /jobs/ | Opcional. Registrar una descripción de puesto una vez y reutilizarla job_id. | Gratis |
| Traducir | POST /translate/ | Traducir cadenas o documentos PDF y DOCX. | $0.01 por solicitud (ver precios ) |
| Detectar idioma | POST /detect-language/ | código ISO 639-1 para un texto o hasta 200. | $0.001 por solicitud |
| Resumen de la entrevista | POST /summary/ | Aspectos destacados, señales de alerta, habilidades y una recomendación de contratación a partir de una transcripción o grabación. | $0.01, más $0.002 por minuto para grabaciones |
| Transcribir | POST /transcribe/ | Transcripción de una grabación, sin resumen. | $0.002 por minuto |
| Indicador | POST /prompt/ | Generar, editar, traducir o interrogar el currículum vinculado a su credencial. Con estado. | $0.01 por solicitud |
| Entrevista de selección | POST /screening-interview | Entrevistas de selección alojadas y grabadas con devoluciones firmadas. | $0.02 por invitación enviada |
Tareas en segundo plano
Analizar, evaluar, resumir, transcribir y traducir también se ejecutan en segundo plano: POST /{op}/async respuestas 202 con un task_id de una vez, y se recoge el resultado con GET /{op}/tasks/{task_id} o se recibe mediante callback firmado. Ver Procesamiento en segundo plano y callbacks.
Rutas
Las operaciones síncronas terminan con una barra final (/parse/). Las rutas de tareas en segundo plano (/parse/async,/parse/tasks/{task_id}) y las rutas de filtrado (/screening-interview) se documentan sin ella.
Para la especificación completa, consulte el documento OpenAPI, o revíselo en Swagger UI o ReDoc.
Autenticación
| Encabezado | Valor | Requerido |
|---|---|---|
Authorization | Bearer key_<id>_<secret>, su clave de Consola API | Sí |
Content-Type | application/json o multipart/form-data, según la operación | Sí, en solicitudes con cuerpo |
Una clave de Consola autoriza todas las operaciones, de inmediato. No hay credenciales por endpoint, no hay ámbitos y nada que habilitar. Consulte Autenticación.
No hay encabezado de versión API. La superficie está versionada por ruta, y los cambios aditivos (nuevos campos opcionales, nuevas operaciones) se envían sin romper las llamadas existentes.
Base URL
https://api.curriculo.me/publicApunte su cliente a esa base y agregue la ruta de operación, por ejemplo https://api.curriculo.me/public/parse/.
- Una credencial en todas partes. Una sola clave de Consola autentica todas las operaciones.
- Límites aplicados por clave, , así que una integración ruidosa no puede gastar el presupuesto de otra.
- Las solicitudes fallidas nunca se cobran. Un
4xxo un5xxno le cuesta nada.
Producción es el único entorno publicado.
Formato de solicitud y respuesta
Consulte Solicitudes y respuestas. La versión corta:
/parse/,/evaluate/,/prompt/y/transcribe/tomanmultipart/form-data./detect-language/y/jobs/tomanapplication/json./translate/y/summary/tomanapplication/json, omultipart/form-datapara enviar documentos o grabaciones.- Un documento puede tener hasta 10 MB. El cuerpo de la solicitud puede tener hasta 12 MB, excepto
/summary/, que acepta grabaciones de hasta 100 MB. - Enviar un elemento, obtener el objeto de ese elemento. Enviar varios, obtener los resultados en el orden de entrada.
Procesamiento por lotes
No hay un endpoint de lote separado: la lista es el lote. Hasta 10 documentos por solicitud para análisis y evaluación, hasta 200 textos para traducción y detección de idioma. Consultar Procesamiento por lotes.
Límites de velocidad
| Límite | Valor |
|---|---|
| Por clave API | 600 solicitudes por minuto |
| Por dirección IP | 2.000 solicitudes por minuto |
| Trabajo pesado (análisis, evaluación, resumen) | 3 operaciones al mismo tiempo, compartidas en todo el servicio; solicitudes adicionales en cola |
| Tiempo de espera de la solicitud | 300 segundos |
Consulte Límites de velocidad.
Errores
Los errores son JSON y llevan el estado HTTP que importa. Cada respuesta lleva un encabezado X-Curriculo-Request-Id para citar en soporte. Consulte Errores.
Administración de su cuenta
Las claves, el uso y la facturación se administran en la Consola de desarrollador . Su clave API realiza el trabajo de contratación. No puede crear claves ni cambiar la facturación, por lo que una clave filtrada nunca puede escalar a control de cuenta.
Próximos pasos
- Inicio rápido: cuenta, clave, primera llamada en tres pasos.
- Procesamiento en segundo plano y devoluciones de llamada: trabajo prolongado sin mantener una conexión abierta.
- SDKs de cliente: generar un cliente tipado a partir de la especificación OpenAPI.
- Referencia API: cada campo para cada operación.
Updated