Stelleninserate

Stelleninserate abfragen

Bitte beachten Sie, dass die Ressource unter /jobs standardmässig nur aktiv publizierte Inserate zurückgibt.

Um alle verfügbaren Inserate zu erhalten, geben Sie bitte den Request Header publishedOnly bei Ihrer Anfrage mit und setzen Sie diesen auf den Wert false.

Formate

Stelleninserate können in folgenden Formaten aufgegeben werden:

• Standard-Inserat
• PDF-Inserat
• Individuell gestaltete Inserate (via Erfassung des zugehörigen HTMLs)
• Individuell gestaltete Inserate (via Angabe der URL des extern gehosteten Inserats)

Für alle oben genannten Fälle muss im Stellenmarkt ein Job-Objekt erstellt werden (vgl. POST /jobs). Damit das Inserat in der Stellenmarkt-Suche gefunden werden kann, sind zudem die Angabe des Titels sowie die Rubrizierung in allen Fällen erforderlich.

PDF-Inserate

Erstellen Sie zuerst ein Job-Objekt mit allen erforderlichen Angaben. Anschliessend kann das PDF via POST /jobs/{identityNumber}/pdf zum Inserat hochgeladen werden.

Individuell gestaltete HTML-Inserate

Bei der Erstellung des Job-Objekts kann das individuelle Inserate-HTML über die Property jobhtml angegeben werden.

Bitte beachten Sie, dass zugehörige Assets wie Bilder und CSS nicht hochgeladen werden können. Diese müssen im HTML entsprechend auf einen externen Server adressiert werden.

Individuell gestaltete Inserate via Angabe der URL

Die URL des extern gehosteten Inserats kann via Property externalLink beim Job-Objekt angegeben werden. Bitte verwenden Sie immer https.

Online-Bewerbungen

Online-Bewerbungen via Stellenmarkt können Sie über die Property application.allow erlauben. Beim Eingang von neuen Bewerbungen via Stellenmarkt werden automatisch Benachrichtigungen versendet. Die Häufigkeit der Benachrichtigung sowie die Empfänger-E-Mailadresse können über die beiden Properties application.emailfrequency (tägliche Zusammenfassung oder sofort bei Bewerbungseingang) und application.email festgelegt werden.

Sollen Online-Bewerbungen über ein externes Tool erfolgen, kann die entsprechende URL via Property application.url angegeben werden. In diesem Fall erfolgen natürlich keine Benachrichtigungen über Bewerbungseingänge durch den Stellenmarkt.

Kontaktangaben

Mindestens die Pflichtfelder für die Kontaktangaben sind für jedes Inserat erforderlich.

Sind die Kontaktangaben für Bewerbungen und Anfragen bereits im Inseratetext enthalten, kann die Kontakt E-Mail-Adresse oder aber der gesamte Kontaktblock über die beiden Properties contact.showemail resp. showcontact des Job-Objekts auf Wunsch ausgeblendet werden.

Rechnungskontakt

Mindestens die Pflichtfelder der Rechnungsadresse sind für jedes Inserat erforderlich.

Logo

Via POST /jobs/{identityNumber}/logo kann optional ein Logo zum Inserat hochgeladen werden. Der Upload ist pro Inserat erforderlich.

Über die Property logo.alignment kann die Ausrichtung des Logos, welches im Kopfbereich des Inserats ausgegeben wird, festgelegt werden (linksbündig, mittig zentriert, rechtsbündig).

Die Löschung des Logouploads erfolgt via DELETE /jobs/{identityNumber}/logo.

Profile (Arbeitgeber-Porträt)

Pro Inserat kann maximal 1 Arbeitgeber-Profil (Porträt) zugewiesen werden. Bitte beachten Sie, dass die Profile derzeit nicht über die Stellenmarkt-API erstellt resp. bewirtschaftet werden können.

Nutzen Sie hierfür das reguläre Login des betreffenden Kunden und melden Sie sich im Stellenmarkt an, um ein Profil hinzuzufügen, zu ändern oder zu löschen. Standardmässig kann pro Kunde ein Profil erfasst werden. Benötigen Sie mehrere Profile wenden Sie sich bitte an die webways ag.

Über die Ressourcen unter /profiles können die verfügbaren Arbeitgeberprofile abgerufen werden.

Kategorien und Stellentypen

Die möglichen Stellenmarkt-Kategorien und Stellentypen können über die jeweiligen Ressourcen unter /categories und /employmenttypes abgefragt werden.

Die Kategorien für jobscout und monster (/jobscout/categories und /monster/categories) sind erst bei der Erstellung der Publikation relevant und können an dieser Stelle ignoriert werden.

Inserat aus Vorlage erstellen

Bei der Erstellung von Inseraten über das reguläre Stellenmarkt User-Interface werden diverse Felder (z.B. Kontaktadresse, Rechnungsadresse) automatisch aus dem letzten Inserat oder aus den Kundenangaben übernommen. Zudem ist es möglich, für die Erstellung eines neuen Inserats ein bestehendes Inserat als Vorlage zu verwenden.

Diese Funktionalitäten stehen über die Stellenmarkt-API nicht zur Verfügung. Mindestens die Pflichtangaben müssen somit bei jeder Inserateerstellung immer explizit mitgegeben werden.

Weiterführende Infos

Weitere, detaillierte Informationen entnehmen Sie bitte der API-Definition im OpenAPI-Format, siehe OpenAPI.