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
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 |
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"
curl1200 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
curl1200 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: en-US"
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
curl1200 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: en-US"
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
curl1200 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: en-US"
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: en-US"
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 } ] }