Referencia API

Las API de Google for Jobs le permiten integrar Google for Jobs con facilidad e ir más allá de la integración básica de publicación de ofertas de empleo.

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

https://app.seo-for-jobs.com/api/public. La URL raíz de la API es El token de la API para la autenticación puede solicitarse dentro de su cuenta de SEO for Jobs. Es necesario disponer de 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 previa solicitud.

GET /empleos

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

Parámetros:

ninguno

Respuesta (Ejemplo):


{ lista:









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

CURL (Ejemplo):

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

POST /trabajo

Cree una nueva oferta de empleo 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" (ej.: ["FULLTIME", "PARTTIME"])

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

• salaryValue: Número (ej.: 42.00)

• salaryUnit: NULL o uno de estos "DAY", "HOUR", "WEEK", "YEAR", "MONTH"

• calleAndNo: Cadena

• ciudad: Cadena

• código postal: Cadena (debido a los ceros a la izquierda)

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

• companyName: Cadena

• companyLogoUrl: URL completa a 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 amet consetetur ..." ... }

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:https://www.seo-for-jobs.com/de/jobs/sap-hana-senior-developer"https://app.seo-for-jobs.com/api/public/job'"Lore Ipsum ...",employmentType: ["FULLTIME", "PARTTIME"],streetAndNo: "Jungfernstieg 47",city: "Hamburg",postalCode: "20354",countryCode: "DE",companyName: "SFJ",redirectUrl: " }' ;

PUT /job/{id}

{id}Actualiza una oferta de empleo existente con el correspondiente . 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" (ej.: ["FULLTIME", "PARTTIME"])

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

• salaryValue: Número (ej.: 42.00)

• salaryUnit: NULL o uno de estos "DAY", "HOUR", "WEEK", "YEAR", "MONTH"

• calleAndNo: Cadena

• ciudad: Cadena

• código postal: Cadena (debido a los ceros a la izquierda)

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

• companyName: Cadena

• companyLogoUrl: URL completa a 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 amet consetetur ..." ... }

CURL (Ejemplo):

https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'$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"]}' ;

DELETE /job/{id}

{id}Elimina una oferta de empleo con el correspondiente .

Parámetro:

ninguno

Respuesta (Ejemplo):



{ estado: "ÉXITO" }

CURL (Ejemplo):

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

Errores

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

API_TOKEN_INVALID Eltoken de API proporcionado no se encontró en una cuenta activa. Una cuenta se marca como "activa" cuando tiene un paquete activo.

REQUEST_LIMIT_REACHED Se ha alcanzado el límite diario de solicitudes. 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 una publicación de trabajo específica.