Partnerintegration für Jobbörsen

Ein praktischer Einstieg, um eine Jobbörse über vorhandene API, Feed und Bewerbungsablauf des Partners mit Kit zu verbinden.

Beginnen Sie mit Ihrer vorhandenen Schnittstelle

Kit kann eine Jobbörse anbinden, ohne dass diese ein Kit-spezifisches Protokoll übernehmen muss. Betreiben Sie bereits eine Partner-API, einen XML-Feed-Import, einen OAuth-Ablauf, einen Taxonomie-Endpunkt, Moderations-Callbacks oder einen Vertrag für externe Bewerbungen, integrieren wir uns darin.

Dieser Leitfaden ist eine Checkliste für die Abstimmung, keine Partnern auferlegte Spezifikation. Er verkürzt das erste technische Gespräch: Sie sehen, was Kit heute bereitstellt, welche Entscheidungen üblicherweise nötig sind und wo wir uns an Ihren Ablauf anpassen können.

Important

Ihr Produktionsvertrag bleibt maßgeblich. Wir bilden Kit auf dokumentierte Felder, Authentifizierung, Lebenszyklus, Guthabenregeln und Bewerberablauf der Jobbörse ab. Die Beispiele beschreiben die derzeitigen Möglichkeiten von Kit und unterstellen nicht, dass eine bestimmte Jobbörse diese Formate akzeptiert.

Integrationsformen

Die meisten Partnerschaften verwenden eine oder mehrere dieser Formen:

Form	Geeignet, wenn	Kit liefert
Push an die API der Jobbörse	Die Jobbörse besitzt bereits eine Arbeitgeber- oder Multiposting-API	Erstellen, Aktualisieren, Pausieren/Schließen und Statusabgleich über einen Adapter für diese Jobbörse
Jobbörse ruft einen Feed ab	Die Jobbörse importiert Mandanten- oder ATS-Feeds regelmäßig	Einen öffentlichen, cachebaren XML-Feed pro Arbeitgeber; wir ergänzen den Dialekt anhand des maßgeblichen Schemas der Jobbörse
Externer Bewerbungslink	Die Jobbörse leitet Kandidaten zum ATS des Arbeitgebers	Eine stabile Stellen- oder direkte Bewerbungs-URL mit Quellenzuordnung
Native Bewerbung an Kit	Die Jobbörse erfasst Bewerbungen und darf sie weiterleiten	Eine serverseitige API pro Mandant, vorsignierten Upload für Lebensläufe, Formularschema und Eingangsbestätigung ohne PII

Wir können mit der einfachsten unterstützten Form beginnen und später Status- oder Bewerbungsabgleich ergänzen. Ein Pull-Feed verpflichtet die Jobbörse nicht zum Push-Modell von Kit; eine Push-Integration muss keinen bestehenden Feed-Dialekt von Kit konsumieren.

Vorhandene Kit-Formate

Öffentliche XML- und Atom-Feeds

Jedes gehostete Karriereportal besitzt einen Feed pro Arbeitgeber, der nur Stellen mit laufender Bewerbungsannahme enthält:

https://startupkit.app/careers/example/jobs.xml
https://startupkit.app/careers/example/jobs/atom

Eigene Karriere-Domains stellen dieselben Feeds unter /jobs.xml und /jobs/atom bereit. Kit rendert derzeit die Dialekte Adzuna, Atom 1.0, Jooble, Jobrapido, Talent.com und Uitzendbureau. Sie zeigen, welche Daten verfügbar sind; wir nehmen nicht an, dass eine andere Jobbörse sie akzeptiert. Sobald ein Partner Schema und Beispiel-Nutzlasten liefert, kann Kit einen eigenen Dialekt unter einer stabilen URL rendern. Arbeitgeber, die Talent.com nutzen, folgen Stellen auf Talent.com veröffentlichen.

Feed-Einträge verwenden eine stabile öffentliche Stellen-ID und können enthalten:

Titel und HTML-Beschreibung,
Arbeitgebername, Abteilung/Kategorie, Ort und Remote-Status,
Veröffentlichungs- und Aktualisierungsdatum,
Beschäftigungsart,
Gehaltsminimum, -maximum, Währung und Zeitraum, sofern veröffentlicht,
öffentliche Stellen- und direkte Bewerbungs-URLs mit partnerspezifischer UTM-Zuordnung.

Pausieren oder Schließen entfernt eine Stelle aus dem Feed. Erneutes Öffnen stellt dieselbe stabile Identität wieder her. Inhaltliche Änderungen aktualisieren den bestehenden Eintrag, statt eine zweite Stelle anzulegen.

Öffentliche Jobs-REST-API

Die öffentliche Jobs-API liefert JSON über HTTPS für serverseitige oder Browser-Integrationen:

GET /api/public/v1/jobs
GET /api/public/v1/jobs/:public_token
POST /api/public/v1/jobs/:public_token/applications

Die Liste enthält nur veröffentlichte Stellen. Die Detailantwort ergänzt die bereinigte HTML-Beschreibung und das Bewerbungsformularschema des Arbeitgebers. Jeder Arbeitgeber erstellt ein mandantenspezifisches Schlüsselpaar; Serverintegrationen verwenden den geheimen Schlüssel sk_…. Keiner der Schlüssel kann Bewerberdatensätze lesen.

Native Bewerbungsweiterleitung wird separat vereinbart. Die Jobbörse muss Pflichtfragen, Einschränkungen für Lebensläufe, Einwilligungshinweise, Bot-Schutz und die echte Quelle der Bewerbung bewahren. Akzeptiert eine Jobbörse bereits Bewerbungen, bilden wir ihren Vertrag ab, statt Bewerberdaten in einem allgemeinen Endpunkt zu glätten.

JobPosting-JSON-LD

Jede öffentliche Stelle enthält strukturierte JobPosting-Daten von schema.org auf der kanonischen Seite. Darin stehen stabile Stellen-ID, Arbeitgeber, Beschreibung, Veröffentlichungs- und Ablaufdatum, Ort oder Remote-Anforderungen, Beschäftigungsart, Gehalt soweit vorhanden, direkte Bewerbung und kanonische URL.

JSON-LD hilft bei Auffindbarkeit und Validierung, ersetzt aber keine vereinbarte Veröffentlichungs-API, kein Feed-Schema, keinen Moderationsstatus und keinen Lebenszyklus-Callback.

Signierte Lebenszyklus-Webhooks

Kit kann signierte Webhooks für diese Ereignisse senden:

job_posting.published
job_posting.paused
job_posting.closed
job_posting.reopened

Das Ereignis nennt Mandant und Stelle sowie aktuellen Status und öffentliche URL. Ein Partner kann es als Invalidierungssignal verwenden und danach die kanonische Stelle aus dem vereinbarten Feed oder der API neu abrufen. Siehe Webhooks im Überblick und Sicherheit und Zustellung von Webhooks.

Kanonische Stellendaten

Die vorhandenen Veröffentlichungsflächen von Kit liefern diesen Kernvertrag:

Feld	Hinweise
Stabile Stellen-ID	Das öffentliche Token bleibt bei Änderungen, Pause und Wiedereröffnung gleich
Titel und Beschreibung	Klartexttitel und bereinigte HTML-Beschreibung
Arbeitgeber	Mandantenname; Logo und Website stammen aus dem Arbeitgeberprofil
Abteilung/Kategorie	Wert des Arbeitgebers, bei Bedarf auf die Taxonomie der Jobbörse abgebildet
Ort und Remote	Freitext-Ort, strukturierte Stadt, Region und Ländercode, Remote-Kennzeichen sowie die Länder, aus denen Remote-Kandidaten arbeiten dürfen
Beschäftigung	Beschäftigungsart; partnerspezifische Vertragswerte können bei der Zuordnung erfasst werden
Vergütung	Minimum, Maximum, ISO-Währung und Zeitraum Stunde/Tag/Monat/Jahr, sofern veröffentlicht
Daten	Veröffentlichungs- und letztes Aktualisierungsdatum; geschlossene Stellen verlassen aktive Feeds
URLs	Kanonische Stellen-URL und direkte Bewerbungs-URL
Bewerbungsformular	Pflichtfelder, Screening-Fragen, Einwilligungshinweis und Einschränkungen für Lebensläufe

Jobbörsen verlangen oft zusätzliche kontrollierte Daten wie Erfahrungsstufe, Fähigkeiten, Sprachen, Kategorie-IDs, mehrere Orte, Vertragstaxonomien, Datenschutzhinweise oder kostenpflichtige Paketoptionen. Wir ordnen oder erfassen diese Felder im Prüfschritt der Integration, statt sie in einen verlustbehafteten allgemeinen Wert zu pressen.

Was wir von einem Partner benötigen

Senden Sie vorhandene Dokumentation und Ihren üblichen Ablauf. Die Checkliste hilft, Lücken früh zu erkennen; nicht jeder Punkt muss zutreffen.

Technische und kaufmännische Kontakte
API-, Feed- oder Multiposting-Dokumentation mit Beispielanfragen und -antworten
Sandbox-Zugangsdaten oder sicheres Testkonto
Authentifizierung, Schlüsselrotation, Scopes, Limits und IP-Anforderungen
Taxonomien für Kategorie, Ort, Erfahrungsstufe, Fähigkeit, Vertrag und Gehalt
Pflicht- und optionale Felder sowie Validierungsregeln
Verhalten beim Erstellen, Bearbeiten, Veröffentlichen, Pausieren/Schließen, Wiedereröffnen und Ablaufen
Idempotenz, Wiederholungen, Duplikatvermeidung und Fehlersemantik
Moderationsstatus sowie Polling- oder Callback-Unterstützung
Regeln für externe oder native Bewerbung, Quellenzuordnung, Datenschutz und Aufbewahrung
Paketinhaber, Guthabenverbrauch, Markenauswahl und Testguthaben
Freigabe, Zertifizierung und Support für die Produktion

Tip

Ein funktionierendes Beispiel ist besser als ein neues Dokument. Eine vorhandene Postman Collection, OpenAPI-Datei, ein XML-Beispiel oder Integrationsleitfaden reicht für den Start. Wir passen Kit daran an und dokumentieren nur die Entscheidungen für unsere konkrete Verbindung.

Sicherheit und Bewerberdaten

Öffentliche Feeds und Stellenlisten enthalten Stellendaten, niemals PII von Kandidaten.
Zugangsdaten gelten pro Mandant; Servergeheimnisse gelangen nicht in Browser.
Webhooks sind signiert. Der Empfänger muss Signatur und Anfragealter prüfen, um Wiederholungen abzulehnen.
Bewerbungsdaten werden nur über einen vereinbarten Eingang oder die Kit-Bewerbungsseite des Arbeitgebers angenommen.
Wir bauen keine Partnerintegrationen durch Scraping privater oder undokumentierter Endpunkte.

Partnerschaft beginnen

Senden Sie Ihre vorhandene Integrationsanleitung oder den Namen der zuständigen Person an [email protected]. Wir antworten mit einer knappen Feldzuordnung und dem kleinsten sinnvollen Pilotprojekt für beide Teams.

Kurz-Check

Push-API, Pull-Feed, externe Bewerbung, native Bewerbung oder Kombination auswählen
Vorhandenen Vertrag der Jobbörse und einen Sandbox-Zugang teilen
Feld-/Taxonomiezuordnungen und Guthabenverhalten vereinbaren
Erstellen, Bearbeiten, Schließen, Fehler und Moderation testen
Quellenzuordnung und Datenschutz für Kandidaten prüfen
Mit einem kleinen bezahlten Pilotprojekt starten und danach Status und Bewerbungen beobachten