API de Stafio
Una interfaz abierta a través de la cual tu web, tu sistema de reclutamiento o tu reclutador con IA se conectan a Stafio. Una dirección, un formato de petición y siempre solo los datos de tu cuenta.
POST https://<instance>/api/rpc/call
Content-Type: application/json
Content-Profile: api
Prefer: params=single-object
Authorization: Bearer <token>
{
"version": 8,
"func": "job.list",
"params": { "limit": 20, "offset": 0 }
}Para qué sirve la API
Qué puedes hacer a través de la interfaz
Ofertas de empleo en tu propia web
Muestra en tu web las ofertas de empleo de Stafio; las candidaturas van directamente al proceso de selección, sin exportaciones y sin crear candidatos a mano.
- Lista y detalle de una oferta, con descripción, galería y vídeo
- Responder a una oferta crea el candidato y su candidatura
- El CV se adjunta a la candidatura y se marca como CV del candidato
Candidatos desde un sistema externo
Otra herramienta puede captar los candidatos: un sistema de reclutamiento, una web de empleo o un reclutador con IA que hace un primer filtro por teléfono. Se traspasan a Stafio y, a partir de ahí, la selección, la incorporación, los turnos y el control horario funcionan en un solo lugar.
- Registro de candidatos incluso sin una oferta concreta
- La nota del primer filtro queda con la persona
- Identificación por email; la API rechaza los registros duplicados
Tu propia pasarela SMS
Si tienes tu propia pasarela SMS o una tarifa con descuento con un operador, conéctala a Stafio y los mensajes saldrán a través de ella.
- Configuración de la pasarela y entrega de los mensajes que hay que enviar
- Resultados de entrega notificados a Stafio
- Mensajes y llamadas entrantes en la ficha de la persona
Acceso con la propia cuenta de la integración
El token no se crea a mano: la API lo emite a partir de una clave API. El proveedor de la integración nunca necesita la contraseña de la cuenta con la que se ejecuta.
- Cada integración tiene su propio usuario con un rol de API
- Los centros de trabajo y centros de coste asignados definen el alcance de los datos
- Una clave API se revoca desactivándola, sin tocar la contraseña del usuario
Cómo funciona la API
Una dirección, una misma forma de respuesta
No llamas a rutas distintas para cada función: la petición va siempre al mismo endpoint y el cuerpo indica qué hacer. El cuerpo tiene tres campos: version (versión del contrato), func (nombre lógico de la función) y params. La cabecera Prefer: params=single-object es obligatoria.
La respuesta tiene siempre la misma forma, sea cual sea el resultado. Los errores llegan en la misma envoltura y se distinguen por el campo ok y la estructura error: el cliente tiene un tratamiento uniforme y no tiene que lidiar con distintos códigos de estado.
{
"ok": true,
"version": 8,
"func": "job.list",
"data": [ { "job_id": 1042, "name": "Mozo de almacén" } ],
"meta": { "row_count": 1 },
"error": null
}Resumen de funciones
Qué puede hacer la interfaz
| Función | Para qué sirve | Parámetros principales |
|---|---|---|
ping | Comprobación de disponibilidad | sin parámetros |
job.list | Lista de ofertas de empleo | region_id, work_type_id, partner_id, label_ids, limit, offset |
job.detail | Detalle de una oferta, con descripción, galería y vídeo | job_id |
job.response | Respuesta a una oferta: crea el candidato y su candidatura | job_id, first_name, last_name, email, mobile, response_text, cv_file_name, cv_base64 |
person.register | Registro de candidatos sin vínculo a una oferta | first_name, last_name, email, mobile, cost_center, emergency_contact, note, cv_file_name, cv_base64 |
department.list | Centros de trabajo asignados a la cuenta que hace la llamada | sin parámetros |
cost_center.list | Centros de coste («Quiero trabajar como») | department_id |
sms.gateway.* | Tu propia pasarela SMS: configuración, entrega de mensajes, informes de entrega, mensajes y llamadas entrantes | depende de la función |
La API no envía ningún email por sí sola. Un mensaje de confirmación o de bienvenida solo se crea cuando la llamada incluye el ID de una plantilla de email, que gestionas en tu cuenta.
Módulos relacionados
Combina bien con
Soluciones de RR. HH. a medida
Un portal o una app construidos sobre esta interfaz.
Más información →Reclutamiento y CRM
Los candidatos de la API siguen el proceso de selección habitual.
Más información →Comunicación
Mensajes a través de tu propia pasarela SMS, junto al chat y el email.
Más información →