Referência da API

As APIs do SEO for Jobs permitem que você integre o Google for Jobs com facilidade e vá além da integração básica de postagem de empregos pronta para uso.

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

https://app.seo-for-jobs.com/api/public. O URL raiz da API é O token da API para autenticação pode ser solicitado em sua conta do SEO for Jobs. É necessário ter um pacote ativo para usar a API. O token deve ser enviado por meio 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 /jobs

Obtenha uma lista de todas as publicações de emprego em sua conta.

Parâmetros:

nenhum

Resposta (exemplo):


{ list:









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

CURL (exemplo):

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

POST /job

Crie uma nova postagem de emprego em sua conta.

Parâmetros:

  • status: um dos seguintes "DRAFT" ou "PUBLISHED"

  • título: String

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

  • employmentType: NULL ou uma lista destes "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (por exemplo: ["FULLTIME", "PARTTIME"])

  • salaryCurrency: NULL ou uma destas opções "EUR", "CHF", "INR", "JPY", "USD"

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

  • salaryUnit: NULL ou um destes "DAY" (dia), "HOUR" (hora), "WEEK" (semana), "YEAR" (ano), "MONTH" (mês)

  • streetAndNo: String

  • city: String

  • postalCode (código postal): String (por causa dos zeros à esquerda)

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

  • companyName: String

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

  • redirectUrl: URL completo para redirecionamento após clicar no botão "Apply Button" (Candidatar-se) no Google for Jobs.

Resposta (exemplo):








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

CURL (exemplo):

$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}Atualiza uma postagem de emprego existente com o correspondente . Somente os parâmetros enviados serão atualizados. A atualização será automaticamente enviada ao Google caso o status seja "PUBLISHED" após o processo de atualização.

Parâmetro:

  • status: Um dos seguintes "DRAFT" ou "PUBLISHED"

  • título: String

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

  • employmentType: NULL ou uma lista destes "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (por exemplo: ["FULLTIME", "PARTTIME"])

  • salaryCurrency: NULL ou uma destas opções "EUR", "CHF", "INR", "JPY", "USD"

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

  • salaryUnit: NULL ou um destes "DAY" (dia), "HOUR" (hora), "WEEK" (semana), "YEAR" (ano), "MONTH" (mês)

  • streetAndNo: String

  • city: String

  • postalCode (código postal): String (por causa dos zeros à esquerda)

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

  • companyName: String

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

  • redirectUrl: URL completo para redirecionamento após clicar no botão "Apply Button" (Candidatar-se) no Google for Jobs.

Resposta (exemplo):








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

CURL (exemplo):

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}Exclui uma postagem de emprego com o correspondente .

correspondente:

none

Resposta (exemplo):



{ status: "SUCCESS" }

CURL (Exemplo):

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' ' ;

Erros

Caso ocorra um erro durante o processamento da solicitação, você receberá um dos seguintes códigos:


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


REQUEST_LIMIT_REACHED O limite diário de solicitações foi atingido. Seu limite de solicitações será redefinido em uma janela deslizante de 24 horas.


UPGRADE_NECESSARY A contagem total de trabalhos com o status "PUBLISHED" atingiu seu limite de pacotes. Faça upgrade de sua conta para publicar mais trabalhos.


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