Referência API

SEO for Jobs APIs permitem-lhe integrar o Google for Jobs com facilidade e ir além da integração básica da publicação de trabalhos fora da caixa.

Registar & solicitar ficha API aqui: https://app.seo-for-jobs.com/register

O URL raiz da API é https://app.seo-for-jobs.com/api/public.. O token API para autenticação pode ser solicitado dentro da sua conta SEO para Trabalhos. É necessário um pacote activo para utilizar o API. A ficha tem de ser enviada através do cabeçalho adicional "x-api-token". O limite de pedidos é de 50 pedidos por hora e pode ser aumentado a pedido.

GET /jobs

Obtenha uma lista de todas as ofertas de emprego dentro da sua conta.

Parâmetros:

nenhuma

Resposta (Exemplo):

{
lista: [
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
título: "SAP S/4HANA Senior Developer",
descrição: "Lorem ipsum dolor sit amet
consetetur ..."
...
},
{...}
]
}

CURL (Exemplo):

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

PÓS /Trabalho

Crie um novo anúncio de emprego dentro da sua conta.

Parâmetros:

• estatuto: Um deste "PROJECTO" ou "PUBLICADO".

• título: Cordão

• descrição: descrição HTML (tags permitidas: br, ul, li)

• tipo de emprego: NULL ou lista deste "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRATANTE" (ex.: ["FULLTIME", "PARTTIME"])

• salárioMoeda: NULL ou um destes "EUR", "CHF", "INR", "JPY", "USD".

• valor do salário: Número (ex.: 42,00)

• salárioUnidade: NULL ou um deste "DIA", "HORA", "SEMANA", "ANO", "MÊS".

• streetAndNo: Cordão

• cidade: Corda

• postalCode: Corda (por causa dos zeros de chumbo)

• countryCode: i18n country code (ex. "DE" ou "FR").

• companyName: Corda

• empresaLogoUrl: URL completo para um logótipo (250px x 250px, .png, .jpeg, .jpg)

• redirectUrl: URL completo para redireccionamento após clicar no "Botão Aplicar" dentro do Google para Empregos.

Resposta (Exemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6"
status: "PUBLICADO",
title: "SAP S/4HANA Senior Developer",
descrição: "Lorem ipsum dolor sit amet
consetetur ..."
...
}

CURL (Exemplo):

$curl - XPOST - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' - H "Tipo de conteúdo: aplicação/json" - d '{status: "PUBLICADO",título: "SAP S/4HANA Desenvolvedor Sénior",descrição: "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}

Actualizar um anúncio de emprego existente com o correspondente {id}. Apenas os parâmetros submetidos serão actualizados. A actualização será automaticamente empurrada para o Google caso o estado seja "PUBLICADO" após o processo de actualização.

Parâmetro:

• estatuto: Um deste "PROJECTO" ou "PUBLICADO".

• título: Cordão

• descrição: descrição HTML (tags permitidas: br, ul, li)

• tipo de emprego: NULL ou lista deste "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRATANTE" (ex.: ["FULLTIME", "PARTTIME"])

• salárioMoeda: NULL ou um destes "EUR", "CHF", "INR", "JPY", "USD".

• valor do salário: Número (ex.: 42,00)

• salárioUnidade: NULL ou um deste "DIA", "HORA", "SEMANA", "ANO", "MÊS".

• streetAndNo: Cordão

• cidade: Corda

• postalCode: Corda (por causa dos zeros de chumbo)

• countryCode: i18n country code (ex. "DE" ou "FR").

• companyName: Corda

• empresaLogoUrl: URL completo para um logótipo (250px x 250px, .png, .jpeg, .jpg)

• redirectUrl: URL completo para redireccionamento após clicar no "Botão Aplicar" dentro do Google para Empregos.

Resposta (Exemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
status: "PUBLICADO",
title: "SAP S/4HANA Senior Developer",
descrição: "Lorem ipsum dolor sit amet
consetetur ..."
...
}

CURL (Exemplo):

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

DELETE /job/{id}

Eliminar uma publicação de emprego com o correspondente {id}.

Parâmetros:

nenhuma

Resposta (Exemplo):

{
status: "SUCESSO"
}

CURL (Exemplo):

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'

Erros

No caso de ocorrer um erro durante o processamento do seu pedido, receberá um dos seguintes códigos:

API_TOKEN_INVALID
O Token API fornecido não foi encontrado dentro de uma conta activa. Uma conta é marcada como "activa" quando tem um pacote activo.

REQUEST_LIMIT_REACHED
O limite de pedido diário é atingido. o seu limite de pedido será reiniciado dentro de uma janela deslizante de 24h.

UPGRADE_NECESSARY
A contagem total de empregos com o estatuto "PUBLICADO" atingiu o limite do seu pacote. Por favor, actualize a sua conta para publicar mais trabalhos.

ID_NOT_FOUND
Não foi encontrado o ID fornecido para um anúncio de emprego específico.