Jobs auf der eigenen Website¶

Mit dieser Schnittstelle zeigst du deine offenen Aufträge automatisch auf deiner eigenen Website — statt sie dort von Hand zu pflegen. Du entscheidest bei jedem Auftrag einzeln, ob er öffentlich erscheinen soll. Das Kapitel richtet sich an Administratoren und Disponenten.

Was du veröffentlichst, sieht jeder

Veröffentlichte Aufträge sind für alle im Internet sichtbar — auch für deine Mitbewerber. Den öffentlichen Text schreibst du eigens dafür in das Feld Stellenbeschreibung; die Beschreibung für deine Mitarbeiter bleibt intern und geht nicht nach draußen. Achte trotzdem darauf, was du in die Stellenbeschreibung schreibst: dort haben interne Notizen, Telefonnummern und Namen von Ansprechpartnern nichts zu suchen.

Schritt 1: Schnittstelle einschalten¶

Öffne Verwaltung → API-Verbindungen.
Schalte unter Jobs auf der eigenen Website den Schalter auf Aktiv.

Erst danach erscheint bei den Aufträgen der Haken zum Veröffentlichen. Schaltest du später wieder ab, verschwinden deine Aufträge sofort von deiner Website. Die gesetzten Haken bleiben erhalten und wirken wieder, sobald du erneut einschaltest.

Schritt 2: Zugang anlegen¶

Ein Zugang ist der Schlüssel, mit dem deine Website die Aufträge abruft.

Gib unter Name des Zugangs eine Bezeichnung ein, zum Beispiel „Unternehmenswebsite".
Klicke auf Zugang anlegen.
Kopiere den angezeigten Schlüssel sofort.

Der Schlüssel wird nur einmal angezeigt

Aus Sicherheitsgründen speichert SMARTCHILLI den Schlüssel nicht im Klartext. Wenn du ihn verlierst, legst du einfach einen neuen Zugang an und sperrst den alten. Gib den Schlüssel an die Person weiter, die deine Website betreut — er gehört auf den Server deiner Website und nicht in den Quelltext der Seite.

Einen Zugang, der nicht mehr gebraucht wird oder in falsche Hände geraten ist, sperrst du mit Sperren. Die Sperre wirkt sofort.

Schritt 3: Aufträge veröffentlichen¶

Öffne einen Auftrag und wechsle zum Reiter Jobseite. Dort findest du den Haken Auf der Jobseite veröffentlichen. Darunter klappst du mit Angaben für die Jobseite auf, was dort öffentlich erscheinen soll — Stellenbeschreibung und Ort.

Am Reiter selbst zeigt ein kleines Zeichen, ob der Auftrag gerade veröffentlicht ist — so siehst du den Status, ohne den Reiter erst zu öffnen. Diesen Reiter siehst du nur, wenn deine Organisation die Schnittstelle eingeschaltet hat (Schritt 1).

Der Haken ist zunächst immer aus — er setzt sich nie von selbst, auch nicht bei einem vollständig ausgefüllten Auftrag. Nimmst du ihn bewusst zurück, wird er dir bei diesem Auftrag nicht wieder vorgeschlagen.

Die Stellenbeschreibung¶

Der Text, der öffentlich erscheint, steht im Feld Stellenbeschreibung im aufgeklappten Bereich. Er ist bewusst getrennt von der Beschreibung, die deine Mitarbeiter in ihrer Job-Ansicht sehen: Was du intern notierst — Treffpunkt, Ansprechpartner, Telefonnummern — bleibt intern und geht nie nach draußen.

Schreib die Stellenbeschreibung so, wie du sie in einer Anzeige lesen möchtest. Höchstlänge sind 2.000 Zeichen.

Was ein Auftrag mitbringen muss¶

Veröffentlichen kannst du nur Aufträge mit Bild und Stellenbeschreibung. Fehlt eines von beiden, bleibt der Haken beim Setzen aus und die Oberfläche sagt dir, was noch fehlt — er ist aber jederzeit anklickbar. Fehlt der Text, klappt der Bereich Angaben für die Jobseite dabei von selbst auf. Sobald beides vorhanden ist, lässt der Haken sich setzen, ohne dass du zwischendurch speichern musst.

Ein KI-Bild zählt erst, wenn du es freigeschaltet hast. Ein noch nicht freigeschaltetes KI-Bild ist eine Vorschau mit Wasserzeichen und geht nicht nach außen.

Ort auf der Kachel¶

Der Ort wird aus der Adresse des Auftrags abgeleitet — allerdings nur, wenn sie eindeutig ist. Die vollständige Adresse verlässt SMARTCHILLI nie.

Ist die Adresse nicht eindeutig, bleibt die Kachel ohne Ort. Trage dann im Feld Ort für die Jobseite ein, was auf der Kachel stehen soll, zum Beispiel „Köln". Dieses Feld hat immer Vorrang.

Was nach draußen geht¶

Im aufgeklappten Bereich steht, welche Angaben die Schnittstelle ausliefert: Titel, Stellenbeschreibung, Ort, Zeitraum, Bild, freie Plätze und bis zu fünf Etiketten. Daneben siehst du das Bild in der Größe, in der es ausgeliefert wird.

Wie die Kachel am Ende aussieht, bestimmt deine Website — SMARTCHILLI liefert nur die Angaben. Deshalb zeigen wir dir, was rausgeht, und behaupten kein Aussehen, das wir nicht in der Hand haben.

Bildformat

Auftragsbilder werden im Hochformat 2 : 3 zugeschnitten. Das ist dasselbe Format, in dem deine Mitarbeiter die Bilder beim Durchblättern der Jobs sehen. Wenn die Person, die deine Website betreut, dieses Verhältnis übernimmt, sieht die Kachel dort genauso aus wie in der Vorschau.

Zusätzliche Angaben über Tags¶

Auf der Kachel kannst du frei formulierte Angaben als kleine Etiketten anzeigen — zum Beispiel „Stundenlohn: ab 14,96 €" oder „Gastronomie". SMARTCHILLI wertet den Inhalt nicht aus, es zeigt genau das an, was du schreibst.

Öffne Verwaltung → Tags.
Lege eine Tag-Gruppe an, zum Beispiel „Veröffentlichung", oder wähle eine bestehende.
Setze bei der Gruppe den Haken Auf der Jobseite anzeigen.
Lege in dieser Gruppe die Tags an, die du anzeigen willst.
Hänge die passenden Tags an deine Aufträge.

Nur freigegebene Gruppen gehen nach außen

Ohne diesen Haken bleibt eine Tag-Gruppe intern. Setze ihn nur bei Gruppen, die du wirklich veröffentlichen willst — interne Kategorien wie „Personengruppen" haben auf einer öffentlichen Website nichts zu suchen.

Je Kachel werden höchstens fünf Etiketten angezeigt. Hängst du mehr an, weist die Vorschau darauf hin.

Wie viele Aufträge erscheinen¶

Es werden höchstens 30 Aufträge der nächsten drei Monate ausgeliefert, die nächsten Termine zuerst. Hast du mehr veröffentlicht, siehst du unter Verwaltung → API-Verbindungen einen Hinweis, wie viele Aufträge derzeit nicht erscheinen. Nimm dann einzelne Haken zurück, damit die wichtigsten Aufträge sichtbar bleiben.

Abgesagte, geschlossene und gelöschte Aufträge verschwinden von selbst.

KI-Bilder¶

Ist das Bild eines Auftrags mit KI erzeugt, liefert SMARTCHILLI es ausschließlich mit eingebranntem Hinweis aus: „Mit KI erzeugte Visualisierung – keine Realaufnahme". Das ist gesetzlich vorgeschrieben (Artikel 50 der EU-KI-Verordnung) und lässt sich nicht abschalten. Innerhalb von SMARTCHILLI siehst du das Bild weiterhin ohne diesen Hinweis.

Für die Person, die deine Website betreut¶

Die Aufträge werden als JSON bereitgestellt:

GET https://app.smartchilli.de/api/public/jobs
X-Api-Key: <geheimer Schlüssel>

Je Auftrag werden geliefert: Titel, Stellenbeschreibung, Ort, Beginn und Ende, benötigte und bereits besetzte Plätze, Bild-Adresse, ein Kennzeichen für KI-Bilder sowie die Etiketten. Der Feldname im JSON bleibt unverändert Description — für deine Website ändert sich nichts, nur der Inhalt kommt jetzt aus der Stellenbeschreibung.

Empfohlenes Bildformat: Hochformat 2 : 3 (zum Beispiel 1024 × 1536 Pixel). In diesem Verhältnis werden die Bilder in SMARTCHILLI zugeschnitten. Stelle die Kacheln auf der Website ebenfalls auf 2 : 3 und beschneide sie mittig (object-fit: cover) — dann wird kein Bild verzerrt.

Soll die Website die Aufträge direkt im Browser laden, trage beim Zugang die erlaubten Domains ein und verwende statt des geheimen Schlüssels die angezeigte Kennung für das Website-Widget:

GET https://app.smartchilli.de/api/public/jobs/w/<Kennung>

Abrufe von nicht eingetragenen Domains werden abgewiesen.