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