Puestos

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

Relacionado

Guía rápida > Crea un puesto

Endpoints

POST
/v1/jobsGET
/v1/jobs/:idPOST
/v1/jobs/:idDELETE
/v1/jobs/:idGET
/v1/jobs/:id/testGET
/v1/jobs/:id/reportPOST
/v1/jobs/:id/applicants/:applicantIdDELETE
/v1/jobs/:id/applicants/:applicantIdGET
/v1/jobs/:id/view/:applicantIdGET
/v1/jobs/:id/compare/:applicantId

Crear puesto

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

Parámetro	Descripción
name	Nombre
companyId	Identificador de la empresa
peopleInCharge _opcional	¿Tiene personas a cargo?
showCompany _opcional	¿Mostrar nombre de la empresa?
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
level _opcional	Nivel profesional
function _opcional	Función
sector _opcional	Sector

Resultado

Devolverá el identificador único si la creación del puesto ha tenido éxito. Puede devolver un error si hay parámetros inválidos.

Terminal
$curl URL_API/api/v1/jobs \>  -u CLIENT_SECRET: \>  -d "name"="Puesto de prueba" \>  -d "companyId"=COMPANY_ID \>  -d "peopleInCharge"=false \>  -d "showCompany"=true \>  -d "country"="ES" \>  -d "province"="B" \>  -d "city"="Barcelona" \>  -d "employees"=1 \>  -d "educationalLevel"=3 \>  -d "level"=5 \>  -d "function"=21 \>  -d "sector"=71

JSON
 {   "jobId": JOB_ID }

Editar puesto

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

Parámetro	Descripción
name _opcional	Nombre
peopleInCharge _opcional	¿Tiene personas a cargo?
showCompany _opcional	¿Mostrar nombre de la empresa?
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
level _opcional	Nivel profesional
function _opcional	Función
sector _opcional	Sector

Terminal
$curl URL_API/api/v1/jobs/JOB_ID \>  -u CLIENT_SECRET: \>  -d "name"="Puesto de prueba editado"

curl
 1200 OK

Obtener puesto

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

Parámetro
No hay parámetros

Resultado

Si el identificador es válido devolverá los datos del puesto más el estado de su descripción described, si ha sido descrito como estándar standard, si está totalmente registrado dataFilled y los profesionales applicants que se han postulado.

Terminal
$curl URL_API/api/v1/jobs/JOB_ID \>  -u CLIENT_SECRET:

JSON
   {     "applicants": [],     "city": "Mataró",     "companyId": 1328778,     "country": "ES",     "cp": "08301",     "created": "2021-06-10 16:02:18.327668+00:00",     "dataFilled": true,     "described": true,     "describedValues": false,     "describedPersonality": false,     "function": 0,     "jobId": 61094,     "level": 0,     "name": "Job renamed",     "peopleInCharge": false,     "province": "B",     "sector": 0,     "showCompany": false,     "standard": false,     "standardValues": false,     "standardPersonality": false   }

Eliminar puesto

Elimina el puesto especificado de la aplicación.

Parámetro
No hay parámetros

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

curl
 1200 OK

Obtener link para describir el 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/jobs/JOB_ID/test \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

JSON
 {   "expires_in": COMPANY_TOKEN_EXPIRES,   "url": "URL_FRONTEND/register/job?token=COMPANY_TOKEN" }

Obtener link del informe del 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/jobs/JOB_ID/report \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

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

Añadir profesional

Añade el profesional al puesto 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/jobs/JOB_ID/applicants/APPLICANT_ID \>  -u CLIENT_SECRET: \>  -X POST

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

Eliminar profesional

Elimina el profesional del puesto especificado.

Parámetro
No hay parámetros

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

curl
 1200 OK

Obtener link del informe de un 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/jobs/JOB_ID/view/APPLICANT_ID \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

JSON
 {   "expires_in": COMPANY_TOKEN_EXPIRES,   "url": "URL_FRONTEND/jobs/JOB_ID/applicants/APPLICANT_ID/report?token=COMPANY_TOKEN" }

Obtener link del informe de comparación de un 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/jobs/JOB_ID/compare/APPLICANT_ID \>  -u CLIENT_SECRET: \>  -H "Accept-Language: es-ES"

JSON
 {   "expires_in": COMPANY_TOKEN_EXPIRES,   "url": "URL_FRONTEND/jobs/JOB_ID/applicants/APPLICANT_ID/report?selected=compare&token=COMPANY_TOKEN" }

Última actualización el 5 ene 2020.