Referência API

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

Registre-se e solicite o token API aqui: https://app.seo-for-jobs.com/register

A URL raiz da API é https://app.seo-for-jobs.com/api/public.. O token API para autenticação pode ser solicitado dentro de sua conta SEO para empregos. Um pacote ativo é necessário para utilizar o API. A ficha tem que ser enviada através do cabeçalho adicional "x-api-token". O limite de solicitação é de 50 solicitações por hora e pode ser aumentado mediante solicitação.

GET / empregos

Obtenha uma lista de todos os anúncios de emprego dentro de sua conta.

Parâmetros:

nenhuma

Resposta (Exemplo):

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

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 de sua conta.

Parâmetros:

• status: Um deste "PROJETO" 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 principais)

• countryCode: i18n country code (por exemplo, "DE" ou "FR").

• companyName: Cordão

• empresaLogoUrl: URL completa para um logotipo (250px x 250px, .png, .jpeg, .jpg)

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

Resposta (Exemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6"
status: "PUBLICADO",
título: "SAP S/4HANA Desenvolvedor Sênior",
descrição: "Lorem ipsum dolor sit ametconsetetur ...
"
...
}

CURL (Exemplo):

$curl - XPOST - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' - H "Content-type: application/json" - d '{status: "PUBLICADO",título: "SAP S/4HANA Desenvolvedor Sênior",descrição: "Lore Ipsum ...",tipo de emprego: 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}

Atualizar um anúncio de emprego existente com o correspondente {id}. Somente os parâmetros apresentados serão atualizados. A atualização será automaticamente enviada para o Google caso o status seja "PUBLICADO" após o processo de atualização.

Parâmetro:

• status: Um deste "PROJETO" 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 principais)

• countryCode: i18n country code (por exemplo, "DE" ou "FR").

• companyName: Cordão

• empresaLogoUrl: URL completa para um logotipo (250px x 250px, .png, .jpeg, .jpg)

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

Resposta (Exemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
status: "PUBLICADO",
título: "SAP S/4HANA Desenvolvedor Sênior",
descrição: "Lorem ipsum dolor sit ametconsetetur ...
"
...
}

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: "SUCCESS"
}

CURL (Exemplo):

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

Erros

Caso ocorra um erro durante o processamento de seu pedido, você receberá um dos seguintes códigos:

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

REQUEST_LIMIT_REACHED
O limite diário de solicitação é atingido. seu limite de solicitação será redefinido dentro de uma janela deslizante de 24h.

UPGRADE_NECESSARY
A contagem total de empregos com o status "PUBLICADO" atingiu seu limite de pacotes. Por favor, atualize sua conta para publicar mais empregos.

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