Referencia de la API

Las API de SEO for Jobs le permiten integrar Google for Jobs con facilidad y van más allá de la integración básica de la publicación de ofertas de empleo de forma inmediata.

Regístrese y solicite el token de la API aquí: https://app.seo-for-jobs.com/register

La URL raíz de la API es https://app.seo-for-jobs.com/api/public.. El token de la API para la autenticación se puede solicitar dentro de su cuenta de SEO for Jobs. Es necesario un paquete activo para utilizar la API. El token debe enviarse a través de la cabecera adicional "x-api-token". El límite de solicitudes es de 50 solicitudes por hora y puede aumentarse si se solicita.

GET /jobs

Obtenga una lista de todas las ofertas de empleo de su cuenta.

Parámetros:

ninguno

Respuesta (Ejemplo):

{
list: [
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur
.
.." ...
},
{...}
]
}

CURL (Ejemplo):

$curl - XGET - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' 'https://app.seo-for-jobs.com/api/public/jobs'

POST /trabajo

Cree un nuevo puesto de trabajo dentro de su cuenta.

Parámetros:

• Estado: Uno de estos "BORRADOR" o "PUBLICADO".

• título: Cadena

• descripción: descripción HTML (etiquetas permitidas: br, ul, li)

• employmentType: NULL o lista de este "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (eg.: ["FULLTIME", "PARTTIME"])

• salaryCurrency: NULL o una de estas "EUR", "CHF", "INR", "JPY", "USD".

• salaryValue: Número (por ejemplo: 42,00)

• salaryUnit: NULL o una de estas "DAY", "HOUR", "WEEK", "YEAR", "MONTH

• streetAndNo: Cadena

• ciudad: Cadena

• Código postal: Cadena (por los ceros a la izquierda)

• countryCode: código de país i18n (por ejemplo, "DE" o "FR").

• companyName: Cadena

• companyLogoUrl: URL completa de un logotipo (250px x 250px, .png, .jpeg, .jpg)

• redirectUrl: URL completa para redirigir después de hacer clic en el "botón de solicitud" dentro de Google for Jobs.

Respuesta (Ejemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6"
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur ...
"
...
}

CURL (Ejemplo):

$curl - XPOST - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' - H "Content-type: application/json" - d '{status: "PUBLISHED",title: "SAP S/4HANA Senior Developer",description: "Lore Ipsum ...",employmentType: ["FULLTIME", "PARTTIME"],streetAndNo: "Jungfernstieg 47",city: "Hamburg",postalCode: "20354",countryCode: "DE",companyName: "SFJ",redirectUrl: "https://www.seo-for-jobs.com/de/jobs/sap-hana-senior-developer"}' 'https://app.seo-for-jobs.com/api/public/job'

PUT /job/{id}

Actualice un puesto de trabajo existente con el correspondiente {id}. Sólo se actualizarán los parámetros enviados. La actualización se enviará automáticamente a Google en caso de que el estado sea "PUBLICADO" tras el proceso de actualización.

Parámetro:

• Estado: Uno de estos "BORRADOR" o "PUBLICADO".

• título: Cadena

• descripción: descripción HTML (etiquetas permitidas: br, ul, li)

• employmentType: NULL o lista de este "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (eg.: ["FULLTIME", "PARTTIME"])

• salaryCurrency: NULL o una de estas "EUR", "CHF", "INR", "JPY", "USD".

• salaryValue: Número (por ejemplo: 42,00)

• salaryUnit: NULL o una de estas "DAY", "HOUR", "WEEK", "YEAR", "MONTH

• streetAndNo: Cadena

• ciudad: Cadena

• Código postal: Cadena (por los ceros a la izquierda)

• countryCode: código de país i18n (por ejemplo, "DE" o "FR").

• companyName: Cadena

• companyLogoUrl: URL completa de un logotipo (250px x 250px, .png, .jpeg, .jpg)

• redirectUrl: URL completa para redirigir después de hacer clic en el "botón de solicitud" dentro de Google for Jobs.

Respuesta (Ejemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur ...
"
...
}

CURL (Ejemplo):

$curl - XPUT - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' - H "Content-type: application/json" - d '{title: "SAP S/4HANA Junior Developer",employmentType: ["FULLTIME"]}' 'https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'

DELETE /job/{id}

Elimine un puesto de trabajo con el correspondiente {id}.

Parámetros:

ninguno

Respuesta (Ejemplo):

{
estado: "SUCCESS"
}

CURL (Ejemplo):

curl - XDELETE - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' 'https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'

Errores

En caso de que se produzca un error al procesar su solicitud, obtendrá uno de los siguientes códigos:

API_TOKEN_INVALID
El token de API proporcionado no se ha encontrado en una cuenta activa. Una cuenta está marcada como "activa" cuando tiene un paquete activo.

REQUEST_LIMIT_REACHED
Se ha alcanzado el límite de solicitudes diario. su límite de solicitudes se restablecerá en un plazo de 24 horas.

UPGRADE_NECESSARY
El recuento total de trabajos con el estado "PUBLICADO" ha alcanzado su límite de paquetes. Por favor, actualice su cuenta para publicar más trabajos.

ID_NOT_FOUND
No se ha encontrado el ID proporcionado para un puesto de trabajo específico.