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

https://app.seo-for-jobs.com/api/public. API:n pääkäyttäjän URL-osoite on API-tunniste todennusta varten voidaan pyytää SEO for Jobs - tililläsi. API:n käyttäminen edellyttää aktiivista pakettia. Tunnus on lähetettävä lisäotsikon "x-api-token" kautta. Pyyntöraja on 50 pyyntöä tunnissa, ja sitä voidaan lisätä pyynnöstä.

GET /jobs

Hae luettelo kaikista tililläsi olevista työpaikkailmoituksista.

Parametrit:

.

Vastaus (esimerkki):


{ list:









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

CURL (esimerkki):

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

POST /job

Luo uusi työpaikkailmoitus tililläsi.

Parametrit:

  • status: Jokin näistä "DRAFT" tai "PUBLISHED".

  • 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 näistä "DAY", "HOUR", "WEEK", "YEAR", "MONTH".

  • streetAndNo: merkkijono

  • city: String

  • postalCode: String (johtavien nollien 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, joka ohjataan Google for Jobsin "Apply Button" - painikkeen napsauttamisen jälkeen.

Vastaus (esimerkki):








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

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: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}Päivitetään olemassa oleva työpaikkailmoitus vastaavalla . Vain lähetetyt parametrit päivitetään. Päivitys siirretään automaattisesti Googleen, jos päivitysprosessin jälkeen tila on "PUBLISHED".

Parametri:

  • status: Jokin näistä "DRAFT" tai "PUBLISHED".

  • 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 näistä "DAY", "HOUR", "WEEK", "YEAR", "MONTH".

  • streetAndNo: merkkijono

  • city: String

  • postalCode: String (johtavien nollien 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, joka ohjataan Google for Jobsin "Apply Button" - painikkeen napsauttamisen jälkeen.

Vastaus (esimerkki):








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

CURL (esimerkki):

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}Poistaa työpaikkailmoituksen, jossa on vastaava .

Parametri:

none

Vastaus (esimerkki):



{ status: "SUCCESS" } }

CURL (Esimerkki):

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

Virheet

Jos pyynnön käsittelyssä tapahtui virhe, saat jonkin seuraavista koodeista:


API_TOKEN_INVALID
Annettua API-tunnusta ei löytynyt aktiiviselta tililtä. Tili merkitään "aktiiviseksi", kun sillä on aktiivinen paketti.


REQUEST_LIMIT_REACHED Päivittäinen pyyntöraja on saavutettu. pyyntörajasi nollataan liukuvassa 24 tunnin ikkunassa.


UPGRADE_NECESSARY Niiden töiden kokonaismäärä, joiden tila on "PUBLISHED", on saavuttanut pakettirajan. Päivitä tilisi, jotta voit julkaista lisää töitä.


ID_NOT_FOUND Tietyn työpaikkailmoituksen annettua tunnusta ei löytynyt.