This page is not yet translated into this language.

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

Crear puesto

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

ParámetroDescripción
nameNombre
companyIdIdentificador de la empresa
peopleInCharge opcional¿Tiene personas a cargo?
showCompany opcional¿Mostrar nombre de la empresa?
country opcionalPaís en estándar ISO 3166-2
province opcionalProvincia en estándar ISO 3166-2
city opcionalCiudad o población
educationalLevel opcionalNivel de estudios
level opcionalNivel profesional
function opcionalFunción
sector opcionalSector

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
Respuesta
{ "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ámetroDescripción
name opcionalNombre
peopleInCharge opcional¿Tiene personas a cargo?
showCompany opcional¿Mostrar nombre de la empresa?
country opcionalPaís en estándar ISO 3166-2
province opcionalProvincia en estándar ISO 3166-2
city opcionalCiudad o población
educationalLevel opcionalNivel de estudios
level opcionalNivel profesional
function opcionalFunción
sector opcionalSector
Terminal
$curl URL_API/api/v1/jobs/JOB_ID \> -u CLIENT_SECRET: \> -d "name"="Puesto de prueba editado"
Respuesta
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:
Respuesta
{ "applicants": [], "city": "Mataró", "companyId": 1328778, "country": "ES", "cp": "08301", "created": "2021-06-10 16:02:18.327668+00:00", "dataFilled": true, "described": true, "function": 0, "jobId": 61094, "level": 0, "name": "Job renamed", "peopleInCharge": false, "province": "B", "sector": 0, "showCompany": false, "standard": false, "test": true }

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
Respuesta
1200 OK

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

Parámetro
No hay parámetros
Terminal
$curl URL_API/api/v1/jobs/JOB_ID/test \> -u CLIENT_SECRET: \> -H "Accept-Language: en-US"
Respuesta
{ "expires_in": COMPANY_TOKEN_EXPIRES, "url": "URL_FRONTEND/register/job?token=COMPANY_TOKEN" }

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

Parámetro
No hay parámetros
Terminal
$curl URL_API/api/v1/jobs/JOB_ID/report \> -u CLIENT_SECRET: \> -H "Accept-Language: en-US"
Respuesta
{ "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
Respuesta
{ "coincidence": {{JOB_JOB_MATCH_PERCENTAGE}} }

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
Respuesta
1200 OK

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

Parámetro
No hay parámetros
Terminal
$curl URL_API/api/v1/jobs/JOB_ID/view/APPLICANT_ID \> -u CLIENT_SECRET: \> -H "Accept-Language: en-US"
Respuesta
{ "expires_in": COMPANY_TOKEN_EXPIRES, "url": "URL_FRONTEND/jobs/JOB_ID/applicants/APPLICANT_ID/report?token=COMPANY_TOKEN" }

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

Parámetro
No hay parámetros
Terminal
$curl URL_API/api/v1/jobs/JOB_ID/compare/APPLICANT_ID \> -u CLIENT_SECRET: \> -H "Accept-Language: en-US"
Respuesta
{ "expires_in": COMPANY_TOKEN_EXPIRES, "url": "URL_FRONTEND/jobs/JOB_ID/applicants/APPLICANT_ID/report?selected=compare&token=COMPANY_TOKEN" }
Last updated on Jan 5, 2020.