Schnittstelle (API) zur Abfrage der Stellenanzeigen

Die veröffentlichten Stellenanzeigen von onboard können über eine JSON-Schnittstelle abgefragt werden.

API-Endpunkte

Der Endpunkt ist über folgend URL erreichbar:

https://<Unternehmen>.onboard.org/exports/v2/jobs.json

Zusätzlich gibt es eigene Endpunkte pro Sprache. Die Sprache kann im ISO 639-1-Format angegeben werden (z.B. „de“, „it“, oder „en“). Der Endpunkt ist über folgende URLs erreichbar:

https://<Unternehmen>.onboard.org/<Sprache>/exports/v2/jobs.json

https://<Unternehmen>.onboard.org/de/exports/v2/jobs.json
https://<Unternehmen>.onboard.org/it/exports/v2/jobs.json
https://<Unternehmen>.onboard.org/en/exports/v2/jobs.json
...

Es ist auch möglich, einzelne Stellenanzeigen abzufragen:

https://<Unternehmen>.onboard.org/exports/v2/jobs/<Job-ID>.json

Parameter

• campaign: Kampagne, über welche die Stellenanzeigen gefiltert werden sollen
• publication_channel: Kanal, über welchen die Stellenanzeigen gefiltert werden sollen
• show_on_career_site: Nur Stellenanzeigen anzeigen, welche auf der Webseite angezeigt werden. Der Wert kann true oder false sein.
• location_id: Zeigt nur Stellenanzeigen von diesem Standort an
• location_ids[]: Zeigt nur Stellenanzeigen von diesen Standorten an
• department_id: Zeigt nur Stellenanzeigen von dieser Abteilung an
• department_ids[]: Zeigt nur Stellenanzeigen von diesen Abteilungen an
• subtree_department_id: Zeigt nur Stellenanzeigen von dieser Abteilung sowie deren Unter-Abteilungen an

Beispiel:

https://<Unternehmen>.onboard.org/de/exports/v2/jobs.json?publication_channel=292hAjyX&show_on_career_site=true

Den genauen API-Endpunkt mit Tracking-Parametern erhalten Sie von unserem Support-Team auf Anfrage.

Inhalt

Bestimmte Felder sind übersetzbar (z.B. „title“). Ist keine Sprache in der URL angegeben, werden alle möglichen Übersetzungen ausgegeben (z.B. „title_de“, „title_en“). Ist eine Sprache angegeben, wird nur die ausgewählte Sprache zurückgegeben.

Die Schnittstelle enthält alle benötigten Informationen zur Stellenanzeige:

• id: Eindeutige ID
• languages: Sprachen, in denen die Stellenanzeige veröffentlicht wurde
• published_at: Veröffentlichungsdatum
• url: Link zur Stellenanzeige
• form_url: Link direkt zum Bewerbungsformular
• image_url: Hintergrundbild der Stellenanzeige
• title: Titel
• description: Beschreibung (kann HTML-Code enthalten)
• business: Informationen zum Unternehmen
• locations: Standort(e). Für Details siehe hier.
• departments: Abteilung(en). Für Details siehe hier.
• types: Typ Anstellungsverhältnis. Mögliche Werte:
  full_time: Vollzeit
  part_time: Teilzeit
  remote: Remote (Home Office) möglich
  internship: Praktikum
  apprenticeship: Lehre
  unlimited: unbefristet
  limited: befristet
  minor: geringfügig
• salary_type: Gehalt. Mögliche Werte:
  none: keine Angabe
  value: Wert
  range: Gehaltsspanne
  text: Text
• salary_value: Betrag Gehalt, wenn salary_type auf value gesetzt ist
• salary_min_value: Betrag Gehalt Minimum, wenn salary_type auf range gesetzt ist
• salary_max_value: Betrag Gehalt Maximum, wenn salary_type auf range gesetzt ist
• salary_value_type: Typ Gehalt. Mögliche Werte:
  gross: brutto
  net: netto
• formatted_salary: Gehaltsangabe als Text formattiert, falls verfügbar
• entry_date_type: Eintrittsdatum. Mögliche Werte:
  none: keine Angabe
  immediately: ab sofort
  arrangement: nach Absprache
  date: mit Datum
• entry_date: Eintrittsdatum, wenn entry_date_type auf date gesetzt ist
• background_image_url: Hintergrundbild der Stellenanzeige
• contact_person: Name Ansprechperson (optional)
• contact_phone: Telefonnummer Ansprechperson (optional)
• contact_email: E-Mail Ansprechpersion (optional)
• reference: Referenznummer der Stellenanzeige (optional)

Beispiel-Antwort der Schnittstelle:

[
  {
    "id": "KeN07w4q",
    "languages": ["de", "it"],
    "types": ["full_time"]
    "published_at": "2021-02-26",
    "url": "https://demo.onboard.org/de/jobs/KeN07w4q",
    "form_url": "https://demo.onboard.org/jobs/KeN07w4q/form?show_logo=true",
    "title": "Kundenbetreuer (m/w)",
    "description": "\u003ch3\u003eBeschreibung\u003c/h3\u003e\n\u003cp style=\"text-align: justify;\"\u003eBeispieltext: Lorem ipsum dolor sit amet.\u003c/p\u003e",
    "business": { "id": "XQmwJ3e9", "subdomain": "demo", "title_de": "Looptec New Media", "title_it": "Looptec New Media" },
    "locations": [{"id": 677, "name_de": "Bozen", "name_it": "Bolzano" }],
    "departments": [{"id": 1276, "name_de": "Produktion", "name_it": "Produzione"}]
  }
]