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.
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'
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.de/jobs/sap-hana-senior-developer"}' 'https://app.seo-for-jobs.com/api/public/job'
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'
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'
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.