Wie kann ich Kenjo API nutzen, um meine individuelle Karriereseite zu erstellen?

Kenjo bietet einen Custom Builder zur Erstellung deiner eigenen Karriereseite. Dieser Custom Builder ist dazu gedacht, eine öffentliche Karriereseite zu erstellen, die die gängigsten Anwendungsszenarien für öffentliche Karriereseiten abdeckt.

Es kann jedoch vorkommen, dass du einen sehr spezifischen Anwendungsfall hast, der nicht durch den Karriereseiten-Builder von Kenjo abgedeckt wird. Für diese Anwendungsfälle stellen wir eine Karriereseiten-API zur Verfügung, mit der du ganz einfach deine eigene Seite erstellen kannst.

Grundsätzlich bietet diese API zwei HTTPS-Endpunkte. Der eine ist ein GET-Endpunkt, über den du alle Informationen zu den Stellenangeboten abrufen kannst, die in deinem Kenjo-Konto veröffentlicht sind. Dieser Endpunkt gibt eine Liste aller öffentlichen Stellen zurück, einschließlich der Felder, die gemäß der Konfiguration der jeweiligen Stelle in Kenjo erforderlich sind und derjenigen, die optional sind.

Wichtige Hinweise:

• Gehe zu Kenjo > Einstellungen > Recruiting-Einstellungen und stelle sicher, dass deine Kenjo-Karriereseite aktiv ist und du eine Subdomain gewählt hast.

• Dieser Endpunkt liefert dir ein JSON mit allen Daten zu den aktiven Stellenangeboten in deinem System.
• Wir empfehlen dir, die Option "Link 'Alle Stellenangebote' ausblenden" in Kenjo zu aktivieren, und zwar über Kenjo > Einstellungen > Recruiting-Einstellungen. Dies wird die bestmögliche Erfahrung für deine Kandidaten gewährleisten.

Beispiel für den GET-Endpunkt zum Abrufen der Daten deiner offenen Positionen:

{
    [...]
    "activePositions": [
        {
            "_id": "5b822fb092687f00148b2ddd",
            "jobTitle": "0100 - Back end developer",
            "customUrl": "back-end-developer-190522",
            "companyName": "Dunder Mifflin",
            "officeName": "NY Office",
            "departmentName": "Quality & Assurance",
            "applicationFormFields": [
              {
                  "_id": "5b997a61613eb600143fffff",
                  "collectionName": "candidate",
                  "fieldApiName": "email",
                  "typeOfField": "field",
                  "fieldCondition": "REQUIRED"
              }
            ]
        },
        {
            "_id": "5b999a5f7bdcad00146bb82b",
            "jobTitle": "Marketing Manager",
            "customUrl": "5b997a5f7bdcad00146ggggg",
            "jobDescription": {
                "html": "<p>We're looking for a marketing manager!</p>"
            },
            "companyName": "Vance Refrigeration",
            "officeName": "Scranton Office",
            "departmentName": "Marketing",
            "positionType": "Full-time",
            "applicationFormFields": [
                {
                    "_id": "5b997a61613eb60014hhhhh",
                    "collectionName": "candidate",
                    "fieldApiName": "firstName",
                    "typeOfField": "field",
                    "fieldCondition": "REQUIRED"
                },
                {
                    "_id": "5b997a61613eb600143aaaaa",
                    "collectionName": "candidate",
                    "fieldApiName": "lastName",
                    "typeOfField": "field",
                    "fieldCondition": "REQUIRED"
                },
                {
                    "_id": "5b997a61613eb60014bbbbbb",
                    "collectionName": "candidate",
                    "fieldApiName": "email",
                    "typeOfField": "field",
                    "fieldCondition": "REQUIRED"
                }
            ]
        }
    ]
}

Der zweite Endpunkt ist ein POST-Endpunkt, der es dir ermöglicht, einen Kandidaten zu erstellen, der einer der im vorherigen Endpunkt aufgeführten Positionen zugeordnet ist. Diese beiden Endpunkte ermöglichen es dir, alle offenen Stellen auf deiner Website aufzulisten und ein Formular für die Zuweisung von Bewerbern zu diesen Stellen anzuzeigen, so dass alle Informationen in Kenjo erscheinen und jederzeit synchronisiert sind.

Wichtige Hinweise:

• Bitte beachte, dass du keine Dokumente in Kenjo einfügen kannst. Aus diesem Grund ist es wichtig, dass alle deine Anhangsfelder in Kenjo in der Positionskonfiguration auf "Deaktiviert" umgeschaltet sind.
• Abgesehen von Dokumenten kannst du in Kenjo auch benutzerdefinierte Felder für Positionen und Kandidaten eingeben. Stelle dazu sicher, dass sie in der Positionskonfiguration entweder als Erforderlich oder Optional gekennzeichnet sind.

Beispiel für den POST-Endpunkt, um einen Bewerber in eine deiner Stellen aufzunehmen:

{
  "positionId": "5b997a5f7bdcad00146fb82b",
  "candidate": {
      "firstName": "Hollywood",
      "lastName": "Fats",
      "email": "hollywood.fats@kenjo.io"
  }
}

Wenn Sie die Endpunkte benötigen, wenden Sie sich bitte an support@kenjo.io und unser Team wird sie Ihnen zur Verfügung stellen.