API-viite

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ä.

GET /työpaikat

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'

POST /job

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'

PUT /job/{id}

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'

DELETE /job/{id}

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'

Virheet

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.