Profesionales

Esta API te permitirá crear, eliminar y actualizar tus profesionales. También podrás añadir y eliminar puestos a tus profesionales, y obtener profesionales individualmente o una lista paginada con todos tus profesionales.

Relacionado

Guía rápida > Crea un profesional

Endpoints

POST
/v1/applicantsGET
/v1/applicants/:idPOST
/v1/applicants/:idDELETE
/v1/applicants/:idGET
/v1/applicants/:id/testDELETE
/v1/applicants/:id/testGET
/v1/applicants/:id/reportPOST
/v1/applicants/:id/jobs/:jobIdDELETE
/v1/applicants/:id/jobs/:jobIdGET
/v1/applicants/:id/view/:jobIdGET
/v1/applicants/:id/compare/:jobIdGET
/v2/apps/:clientId/applicants

Crear profesional

Si el profesional ya se encuentra registrado en la plataforma (el correo electrónico ya existe), se creará una relación sin modificar ningún otro dato.

Los atributos opcionales que no se hayan facilitado los pediremos posteriormente.

Parámetro	Descripción
firstname	Nombre
lastname	Apellidos
email	Correo electrónico
peopleInCharge _opcional	¿Tiene personas a cargo?
image _opcional	Link del avatar
sex _opcional	Sexo _{female, male, neutral}
birthdate _opcional	Fecha de nacimiento en estándar ISO 8601
country _opcional	País en estándar ISO 3166-2
province _opcional	Provincia / Estado en estándar ISO 3166-2
city _opcional	Ciudad
educationalLevel _opcional	Nivel de estudios
company _opcional	Empresa en la que trabaja
employees _opcional	Número de empleados de la empresa
job _opcional	Puesto de trabajo
phone _opcional	Número de teléfono
level _opcional	Nivel profesional
function _opcional	Función
sector _opcional	Sector

Resultado

Devolverá el identificador único si la creación del profesional ha tenido éxito. Puede devolver un error si hay parámetros inválidos o si el correo electrónico ya existe y le pertenece a una empresa.

Terminal
$curl URL_API/api/v1/applicants \>  -u CLIENT_SECRET: \>  -d "firstname"="Profesional de prueba" \>  -d "lastname"="1" \>  -d "email"="applicant@danchiano.com" \>  -d "peopleInCharge"=false \>  -d "image"="https://d347nhcygwz59.cloudfront.net/uploads/info-logo.png" \>  -d "sex"="female" \>  -d "birthdate"="1994-11-29" \>  -d "country"="ES" \>  -d "province"="B" \>  -d "city"="Barcelona" \>  -d "company"="D’Anchiano" \>  -d "job"="Developer" \>  -d "employees"=1 \>  -d "educationalLevel"=3 \>  -d "level"=5 \>  -d "function"=21 \>  -d "sector"=71

JSON
 {   "created": "2024-09-02",   "userId": APPLICANT_ID }

Editar profesional

Actualiza el profesional especificado guardando los valores de los parámetros enviados. Cualquier parámetro no enviado no será actualizado.

Parámetro	Descripción
firstname _opcional	Nombre
lastname _opcional	Apellidos
email _opcional	Correo electrónico
peopleInCharge _opcional	¿Tiene personas a cargo?
image _opcional	Link del avatar
sex _opcional	Sexo _{female, male, neutral}
birthdate _opcional	Fecha de nacimiento en estándar ISO 8601
country _opcional	País en estándar ISO 3166-2
province _opcional	Provincia / Estado en estándar ISO 3166-2
city _opcional	Ciudad
educationalLevel _opcional	Nivel de estudios
company _opcional	Empresa en la que trabaja
employees _opcional	Número de empleados de la empresa
job _opcional	Puesto de trabajo
phone _opcional	Número de teléfono
level _opcional	Nivel profesional
function _opcional	Función
sector _opcional	Sector

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID \>  -u CLIENT_SECRET: \>  -d "firstname"="Profesional de prueba editado"

curl
 1200 OK

Obtener profesional

Obtén los detalles de un profesional existente. Solo necesitarás facilitar el id del profesional que obtuvo al crearlo.

Parámetro
No hay parámetros

Resultado

Si el identificador es válido devolverá los datos del profesional más el estado de su test de competencias test, el estado de su registro dataFilled y los puestos jobs a los que se ha postulado.

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID \>  -u CLIENT_SECRET:

JSON
   {     "userId": 1328780,     "created": "2021-06-10 16:02:19.912706+00:00",     "birthDate": "Tue, 29 Nov 1994 00:00:00 GMT",     "city": "Barcelona",     "company": "D’Anchiano",     "country": "ES",     "cp": null,     "dataFilled": true,     "email": "testapplicanttest@danchiano.com",     "employees": 0,     "firstName": "Applicant",     "function": 0,     "job": "Software developer",     "jobs": [],     "lastName": "Fully registered",     "level": 0,     "peopleInCharge": true,     "phone": null,     "province": "B",     "sector": 0,     "sex": 1,     "educationalLevel": 0,     "testPassed": false,     "testPassedValues": false,     "testPassedPersonality": false   }

Eliminar profesional

Elimina al profesional especificado de la aplicación.

Parámetro
No hay parámetros

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID \>  -u CLIENT_SECRET: \>  -X DELETE

curl
 1200 OK

Obtener link del test

Si el profesional no ha finalizado el test puedes llamar a este método las veces que sea necesario hasta que lo haya finalizado.

Puedes forzar un idioma con la cabecera Accept-Language, los valores válidos son: es-ES, ca-ES, en-US, pt-BR y it-IT.

Parámetro
No hay parámetros

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID/test \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

JSON
 {   "expires_in": APPLICANT_TOKEN_EXPIRES,   "url": "URL_FRONTEND/register/applicant?token=APPLICANT_TOKEN" }

Eliminar test

Elimina el test de un profesional.

Parámetro
No hay parámetros

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID/test \>  -u CLIENT_SECRET: \>  -X DELETE

curl
 1200 OK

Obtener link del informe del profesional

Puedes forzar un idioma con la cabecera Accept-Language, los valores válidos son: es-ES, ca-ES, en-US, pt-BR y it-IT.

Parámetro
No hay parámetros

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID/report \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

JSON
 {   "expires_in": APPLICANT_TOKEN_EXPIRES,   "url": "URL_FRONTEND/report?token=APPLICANT_TOKEN" }

Añadir puesto

Añade el puesto al profesional especificado.

Parámetro
No hay parámetros

Resultado

Devuelve el porcentaje de coincidencia entre el puesto y el profesional.

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID/jobs/JOB_ID \>  -u CLIENT_SECRET: \>  -X POST

JSON
 {   "coincidence": APPLICANT_JOB_MATCH_PERCENTAGE,   "matchPercentage": APPLICANT_JOB_MATCH_PERCENTAGE,   "matchPercentageValues": null,   "matchPercentagePersonality": null }

Eliminar puesto

Elimina el puesto del profesional especificado.

Parámetro
No hay parámetros

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID/jobs/JOB_ID \>  -u CLIENT_SECRET: \>  -X DELETE

curl
 1200 OK

Obtener link del informe de un puesto

Puedes forzar un idioma con la cabecera Accept-Language, los valores válidos son: es-ES, ca-ES, en-US, pt-BR y it-IT.

Parámetro
No hay parámetros

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID/view/JOB_ID \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

JSON
 {   "expires_in": APPLICANT_TOKEN_EXPIRES,   "url": "URL_FRONTEND/jobs/JOB_ID/report?token=APPLICANT_TOKEN" }

Obtener link del informe de comparación de un puesto

Puedes forzar un idioma con la cabecera Accept-Language, los valores válidos son: es-ES, ca-ES, en-US, pt-BR y it-IT.

Parámetro
No hay parámetros

Terminal
$curl URL_API/api/v1/applicants/APPLICANT_ID/compare/JOB_ID \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

JSON
 {   "expires_in": APPLICANT_TOKEN_EXPIRES,   "url": "URL_FRONTEND/jobs/JOB_ID/report?selected=compare&token=APPLICANT_TOKEN" }

Obtener todos tus profesionales

Obtén una lista paginada con todos tus profesionales.

Parámetro	Descripción
p _Opcional	Número de página

Resultado

Devolverá solo datos básicos de tus profesionales.

Terminal
$curl URL_API/api/v2/apps/CLIENT_ID/applicants?p=0 \>  -u CLIENT_SECRET:

JSON
   {     "pagination": {       "count": 24,       "currentPage": 0,       "totalPages": 3     },     "list": [       {         "id": 1328780,         "name": "Applicant Fully registered",         "email": "testapplicanttest@danchiano.com",         "created": "2021-06-10T16:02:19.912Z",         "accessed": "2021-06-10T17:17:41.062Z",         "testPassed": false,         "fullyRegistered": true,         "jobs": 0,         "jobsAddedMe": 0       },       {         "id": 1328779,         "name": "Applicant Fully registered",         "email": "testapplicant@danchiano.com",         "created": "2021-06-10T16:02:19.304Z",         "accessed": "2021-06-10T16:03:04.284Z",         "testPassed": true,         "fullyRegistered": true,         "jobs": 0,         "jobsAddedMe": 0       },       {         "id": 1136338,         "name": "Cesar Rodríguez",         "email": "carb1811@gmail.com",         "created": "2021-01-09T23:00:00.000Z",         "accessed": "2021-01-09T23:00:00.000Z",         "testPassed": true,         "fullyRegistered": true,         "jobs": 0,         "jobsAddedMe": 0       },       {         "id": 1112268,         "name": null,         "email": "locodante138@gmail.com",         "created": "2020-12-26T23:00:00.000Z",         "accessed": "2020-12-26T23:00:00.000Z",         "testPassed": false,         "fullyRegistered": false,         "jobs": 0,         "jobsAddedMe": 0       },       {         "id": 1111260,         "name": "Asly Rodríguez",         "email": "aslymishell25@gmail.com",         "created": "2020-12-24T23:00:00.000Z",         "accessed": "2020-12-25T23:00:00.000Z",         "testPassed": true,         "fullyRegistered": true,         "jobs": 0,         "jobsAddedMe": 0       },       {         "id": 1111162,         "name": null,         "email": "adrianita.vilte09@gmail.com",         "created": "2020-12-24T23:00:00.000Z",         "accessed": "2020-12-24T23:00:00.000Z",         "testPassed": true,         "fullyRegistered": false,         "jobs": 0,         "jobsAddedMe": 0       },       {         "id": 1098233,         "name": "test test",         "email": "prueba10@danchiano.com",         "created": "2020-12-13T23:00:00.000Z",         "accessed": "2020-12-16T23:00:00.000Z",         "testPassed": true,         "fullyRegistered": true,         "jobs": 0,         "jobsAddedMe": 1       },       {         "id": 1092065,         "name": "hola hola",         "email": "holsa@hola.com",         "created": "2020-12-08T23:00:00.000Z",         "accessed": "2020-12-08T23:00:00.000Z",         "testPassed": true,         "fullyRegistered": true,         "jobs": 0,         "jobsAddedMe": 0       }     ]   }

Última actualización el 3 ene 2020.