SEO for Jobs - rajapintojen avulla voit integroida Google for Jobs - palvelun helposti ja mennä perusintegraatiota pidemmälle.
Rekisteröidy ja pyydä API-tunnusta täällä: https://app.seo-for-jobs.com/register
API:n pääkäyttäjän URL-osoite on https://app.seo-for-jobs.com/api/public.. Todentamista varten tarvittavan API-tunnisteen voi pyytää SEO for Jobs - tililtäsi. API:n käyttö edellyttää aktiivista pakettia. Tunnus on lähetettävä lisäotsikon "x-api-token" kautta. Pyyntöraja on 50 pyyntöä tunnissa, ja sitä voidaan nostaa pyynnöstä.
Saat luettelon kaikista tililläsi olevista työpaikkailmoituksista.
Parametrit:
none
Vastaus (esimerkki):
{
list: [
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur
.
.." ...
},
{...}
]
}
CURL (esimerkki):
$curl - XGET - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' 'https://app.seo-for-jobs.com/api/public/jobs'
Luo uusi työpaikkailmoitus tililläsi.
Parametrit:
status
: Jompikumpi seuraavista: "LUONNOS" tai "JULKAISTU".
title
: merkkijono
description
: HTML-kuvaus (sallitut tunnisteet: br, ul, li)
employmentType
: NULL tai luettelo seuraavista: "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (esim. ["FULLTIME", "PARTTIME"]).
salaryCurrency
: NULL tai jokin seuraavista "EUR", "CHF", "INR", "JPY", "USD".
salaryValue
: luku (esim.: 42.00)
salaryUnit
: NULL tai jokin seuraavista "DAY", "HOUR", "WEEK", "YEAR", "MONTH".
streetAndNo
: String
kaupunki
: String
postalCode:
merkkijono (etunollien vuoksi)
countryCode
: i18n-maakoodi (esim. "DE" tai "FR").
companyName
: String
companyLogoUrl
: Logon täydellinen URL-osoite (250px x 250px, .png, .jpeg, .jpg).
redirectUrl
: Täydellinen URL-osoite, jonka kautta Google for Jobs - palvelun "Hae-painiketta" napsauttanut hakija ohjataan uudelleen.
Vastaus (esimerkki):
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6"
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur
..."
...
}
CURL (esimerkki):
$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: "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'
Päivitä olemassa oleva työpaikkailmoitus vastaavalla osoitteella {id}. Vain lähetetyt parametrit päivitetään. Päivitys siirretään automaattisesti Googlelle, jos päivitysprosessin jälkeen sen tila on "JULKAISTU".
Parametri:
status
: Jompikumpi seuraavista: "LUONNOS" tai "JULKAISTU".
title
: merkkijono
description
: HTML-kuvaus (sallitut tunnisteet: br, ul, li)
employmentType
: NULL tai luettelo seuraavista: "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (esim. ["FULLTIME", "PARTTIME"]).
salaryCurrency
: NULL tai jokin seuraavista "EUR", "CHF", "INR", "JPY", "USD".
salaryValue
: luku (esim.: 42.00)
salaryUnit
: NULL tai jokin seuraavista "DAY", "HOUR", "WEEK", "YEAR", "MONTH".
streetAndNo
: String
kaupunki
: String
postalCode:
merkkijono (etunollien vuoksi)
countryCode
: i18n-maakoodi (esim. "DE" tai "FR").
companyName
: String
companyLogoUrl
: Logon täydellinen URL-osoite (250px x 250px, .png, .jpeg, .jpg).
redirectUrl
: Täydellinen URL-osoite, jonka kautta Google for Jobs - palvelun "Hae-painiketta" napsauttamalla sinut ohjataan eteenpäin.
Vastaus (esimerkki):
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur
..."
...
}
CURL (esimerkki):
$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"]}' 'https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'
Poista työpaikkailmoitus ja sitä vastaava {id}.
Parametrit:
ei ole
Vastaus (esimerkki):
{
status: "SUCCESS"
}
CURL (esimerkki):
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'
Jos pyyntöäsi käsiteltäessä tapahtui virhe, saat jonkin seuraavista koodeista:
API_TOKEN_INVALID
Annettua API-tunnusta ei löydetty aktiiviselta tililtä.Tili merkitään "aktiiviseksi", kun sillä on aktiivinen paketti.
REQUEST_LIMIT_REACHED
Päivittäinen pyyntöraja on saavutettu. pyyntöraja nollataan 24 tunnin liukuvassa ikkunassa.
UPGRADE_NECESSARY
Niiden töiden kokonaismäärä, joiden tila on "JULKAISTU", on saavuttanut pakettirajan. Päivitä tilisi, jotta voit julkaista enemmän töitä.
ID_NOT_FOUND
Tietyn työpaikkailmoituksen tunnusta ei löytynyt.