Einführung

Die Jobaktuell Schnittstelle, im Folgenden nur noch mit API bezeichnet, erlaubt es die Stellenangebote eines bei Jobaktuell registrierten Unternehmens zu verwalten. Die API ist nach dem REST-Vorbild organisiert und verwendet HTTP-Statuscodes um Fehler zu kommunizieren. Es werden weitere, bereits in HTTP existierende Funktionen wie HTTP-Authentifizierung und HTTP-Verben (GET, POST, PUT, DELETE) verwendet, die von bereits existierenden HTTP-Clients verstanden werden.

Alle HTTP-Anfragen werden mit HTTP-Antworten im JSON Format beantwortet – das trifft auch für Fehler zu. Die API akzeptiert Daten sowohl im JSON Format, als auch in URL-Kodierung. Im Abschnitt Formate gibt es dazu ausführliche Informationen.

Die API befindet sich unter https://www.jobaktuell.eu/api/v1/ und ist ausschließlich über HTTPS erreichbar. Es gibt keinen Redirect von HTTP auf HTTPS um zu verhindern das Konsumenten versuchen die API über eine unsichere Verbindung zu verwenden. Des Weiteren ist die API nicht öffentlich, sondern kann ausschließlich von Unternehmen mit einem Jobaktuell Account genutzt werden.

Authentifizierung

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/job-categories' \
  -u ':api_token'

curl verwendet -u für die HTTP Basic Authentication Zugangsdaten. Der Doppelpunkt macht deutlich, dass kein Benutzername verwendet wird. ACHTUNG: Nicht vergessen ein echtes API-Token einzusetzen!

Die Authentifizierung gegenüber der API erfolgt mit einem geheimen API-Token. Unternehmen finden das API-Token im Verwaltungsbereich unter Schnittstelle.

Als Mechanismus wird die HTTP Basic Authentication verwendet, als Passwort wird das API-Token verwendet. Ein Benutzername muss nicht angegeben werden. Die Verwendung von HTTP Basic Authentication erlaubt es alle lesenden Endpunkte wie zum Beispiel https://www.jobaktuell.eu/api/v1/job-categories im Webbrowser zu verwenden. Der Webbrowser wird selbstständig nach Benutzername und Passwort fragen, für das Passwort wie bereits erwähnt das API-Token einsetzen.

Fast alle Programmiersprachen und Frameworks sollten eine Möglichkeit bieten HTTP-Anfragen mit Basic Authentication Headern zu versenden. Sollte das nicht der Fall sein, kann der entsprechende Header selbst erstellt werden. Ein solcher Header sieht zum Beispiel so aus:

Authorization: Basic d2lraTpwZWRpYQ==

Die Zeichenkette am Ende des Headers ist die Base64 Kodierung von Benutzername und Passwort in der Form username:password. Da die API nur das Passwort zur Authentifizierung verwendet kann der Benutzername weggelassen und somit in :api_token abgekürzt werden.

Dieser manuell erstellte Header kann jetzt für die Authentifizierung mit jeder HTTP-Anfrage mitgesendet werden.

Branchen

Bei Jobaktuell gibt es festgelegte Branchen, die einem Stellenangebot zugeordnet werden können. Es ist nicht möglich eigene Branchen anzulegen oder zu verwenden. Um ein Ausufern der verfügbaren Branchen zu verhindern sind die einzelnen Branchen sehr grob umrissen.

Attribute einer Branche

Attribut	Datentyp	Beschreibung
`id`	Integer	Einzigartiger Identifikator innerhalb der Branchen.
`title`	String	Titel der Branche.
`slug`	String	Für Menschen lesbarer Ersatz für `id`. Wird in URLs verwendet.
`created_at`	Timestamp	Wann die Branche erstellt wurde.
`updated_at`	Timestamp	Wann die Branche zuletzt aktualisiert wurde.

Branchen auflisten

Definition

GET https://www.jobaktuell.eu/api/v1/job-categories

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/job-categories' \
  -u ':api_token'

Beispiel: JSON Antwort

{
  "job_categories": [
    {
      "id": 1,
      "title": "Bau- und Baunebenberufe",
      "slug": "bau-und-baunebenberufe",
      "created_at": "2015-04-27T15:05:07.311+02:00",
      "updated_at": "2015-04-27T15:05:07.311+02:00"
    },
    {
      "id": 2,
      "title": "Buchhaltung, Controlling",
      "slug": "buchhaltung-controlling",
      "created_at": "2015-04-27T15:05:07.397+02:00",
      "updated_at": "2015-04-27T15:05:07.397+02:00"
    }
  ]
}

Dieser API-Endpunkt gibt eine Liste aller verfügbaren Branchen zurück. Die JSON Antwort hat auf der ersten Ebene das Attribut job_categories, welches ein Array aller Branchen beinhaltet. Jedes Element dieses Arrays ist eine eigene Branche.

Berufslevel

Bei Jobaktuell gibt es festgelegte Berufslevel, die einem Stellenangebot zugeordnet werden können. Es ist nicht möglich eigene Berufslevel anzulegen oder zu verwenden.

Attribute eines Berufslevel

Attribut	Datentyp	Beschreibung
`id`	Integer	Einzigartiger Identifikator innerhalb der Berufslevel.
`title`	String	Titel des Berufslevel.
`slug`	String	Für Menschen lesbarer Ersatz für `id`. Wird in URLs verwendet.
`created_at`	Timestamp	Wann der Berufslevel erstellt wurde.
`updated_at`	Timestamp	Wann der Berufslevel zuletzt aktualisiert wurde.

Berufslevel auflisten

Definition

GET https://www.jobaktuell.eu/api/v1/job-level-categories

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/job-level-categories' \
  -u ':api_token'

Beispiel: JSON Antwort

{
  "job_level_categories": [
    {
      "id": 1,
      "title": "Praktikum",
      "slug": "praktikum",
      "created_at": "2015-04-27T15:05:07.311+02:00",
      "updated_at": "2015-04-27T15:05:07.311+02:00"
    },
    {
      "id": 2,
      "title": "Lehrstelle",
      "slug": "lehrstelle",
      "created_at": "2015-04-27T15:05:07.397+02:00",
      "updated_at": "2015-04-27T15:05:07.397+02:00"
    }
  ]
}

Dieser API-Endpunkt gibt eine Liste aller verfügbaren Berufslevel zurück. Die JSON Antwort hat auf der ersten Ebene das Attribut job_level_categories, welches ein Array aller Berufslevel beinhaltet. Jedes Element dieses Arrays ist eine eigener Berufslevel.

Zeitformen

Bei Jobaktuell gibt es festgelegte Zeitformen, die einem Stellenangebot zugeordnet werden können. Es ist nicht möglich eigene Zeitformen anzulegen oder zu verwenden.

Attribute einer Zeitform

Attribut	Datentyp	Beschreibung
`id`	Integer	Einzigartiger Identifikator innerhalb der Zeitformen.
`title`	String	Titel der Zeitform.
`slug`	String	Für Menschen lesbarer Ersatz für `id`. Wird in URLs verwendet.
`created_at`	Timestamp	Wann die Zeitform erstellt wurde.
`updated_at`	Timestamp	Wann die Zeitform zuletzt aktualisiert wurde.

Zeitformen auflisten

Definition

GET https://www.jobaktuell.eu/api/v1/work-schedule-categories

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/work-schedule-categories' \
  -u ':api_token'

Beispiel: JSON Antwort

{
  "work_schedule_categories": [
    {
      "id": 1,
      "title": "Teilzeit",
      "slug": "teilzeit",
      "created_at": "2015-04-27T15:05:07.311+02:00",
      "updated_at": "2015-04-27T15:05:07.311+02:00"
    },
    {
      "id": 2,
      "title": "Vollzeit",
      "slug": "vollzeit",
      "created_at": "2015-04-27T15:05:07.397+02:00",
      "updated_at": "2015-04-27T15:05:07.397+02:00"
    }
  ]
}

Dieser API-Endpunkt gibt eine Liste aller verfügbaren Zeitformen zurück. Die JSON Antwort hat auf der ersten Ebene das Attribut work_schedule_categories, welches ein Array aller Zeitformen beinhaltet. Jedes Element dieses Arrays ist eine eigene Zeitform.

Stellenangebote

Ein Unternehmen kann bei Jobaktuell beliebig viele Stellenangebote schalten. Es kann für jede Stelle individuell eingestellt werden ob sie inseriert werden soll oder nicht. Für die geographische Sortierung von Stellenangeboten, die in der Jobaktuell Jobbörse zur Verfügung steht, ist es nötig alle Stellenangebote mit Koordinaten zu versehen. Die API kann diese Aufgabe übernehmen und für Stellenangebote automatisch die Koordinaten ermitteln.

Attribute eines Stellenangebots

Attribut	Datentyp	Beschreibung
`id`	Integer	Einzigartiger Identifikator innerhalb der Stellenangebote.
`company_id`	Integer	Referenz auf das zugehörige Unternehmen.
`job_category_ids`	Integer Array	Referenz auf assoziierte Branchen.
`job_level_category_ids`	Integer Array	Referenz auf assoziierte Berufslevel.
`work_schedule_category_ids`	Integer Array	Referenz auf assoziierte Zeitformen.
`title`	String	Titel des Stellenangebots.
`slug`	String	Für Menschen lesbarer Ersatz für `id`. Wird in URLs verwendet.
`description`	String	Die eigentliche Stellenbeschreibung.
`location`	String	Der öffentlich sichtbare Standort der Stelle.
`geographic_location`	String	Der geographische Standort für die Ermittlung der Koordinaten. Ist nicht öffentlich sichtbar und kann von `location` abweichen.
`latitude`	String	Koordinaten für die geographische Sortierung.
`longitude`	String	Koordinaten für die geographische Sortierung.
`is_active`	Boolean	Ist das Stellenangebot aktiv. Nur aktive Stellenangebote werden inseriert.
`salary`	Number	Grundgehalt der ausgeschriebenen Stelle.
`working_hours`	String	Angaben zu den Arbeitszeiten / Stunden.
`runtime_starts_on`	Timestamp	Der Tag mit dem die Schaltung des Stellenangebots beginnen soll.
`runtime_ends_on`	Timestamp	Der Tag mit dem die Schaltung des Stellenangebots enden soll.
`created_at`	Timestamp	Wann das Stellenangebot erstellt wurde.
`updated_at`	Timestamp	Wann das Stellenangebot aktualisiert wurde.

Stellenangebot erstellen

Definition

POST https://www.jobaktuell.eu/api/v1/company/job-positions

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions' \
  -X 'POST' \
  -u ':api_token' \
  -d 'job_position[title]=EntwicklerIn' \
  -d 'job_position[description]=Erfahrung mit automatisierten Tests erwünscht.' \
  -d 'job_position[job_category_ids][]=1' \
  -d 'job_position[job_level_category_ids][]=1' \
  -d 'job_position[work_schedule_category_ids][]=1' \
  -d 'job_position[location]=Salzburg' \
  -d 'job_position[geographic_location]=Salzburg Hbf' \
  -d 'job_position[latitude]=47.813052' \
  -d 'job_position[longitude]=13.045071' \
  -d 'job_position[salary]=40000' \
  -d 'job_position[working_hours]=38 Wochenstunden' \
  -d 'job_position[runtime_starts_on]=2016-12-01' \
  -d 'job_position[runtime_ends_on]=2016-12-31' \
  -d 'job_position[is_active]=1'

Beispiel: JSON Antwort

{
  "job_position": {
    "id": 11,
    "company_id": 3,
    "title": "EntwicklerIn",
    "slug": "entwicklerin",
    "location": "Salzburg",
    "description": "Erfahrung mit automatisiertem Testen erwünscht.",
    "geographic_location": "Salzburg Hbf",
    "latitude": "47.813052",
    "longitude": "13.045071",
    "is_active": true,
    "salary": 40000,
    "working_hours": "38 Wochenstunden",
    "runtime_starts_on": "2016-12-01",
    "runtime_ends_on": "2016-12-31",
    "job_category_ids": [1],
    "job_level_category_ids": [1],
    "work_schedule_category_ids": [1],
    "created_at": "2015-07-30T12:32:34.532+02:00",
    "updated_at": "2015-07-30T12:32:34.532+02:00"
  }
}

Über diesen API-Endpunkt kann ein neues Stellenangebot für das Unternehmen erstellt werden. Bei Erfolg enthält die Antwort das neu erstellte Stellenangebot. Folgende Parameter werden für das Erstellen eines neuen Stellenangebots benötigt bzw. sind erlaubt.

Parameter

Attribut	Datentyp	Beschreibung
`job_category_ids`	Integer Array	Für welche Branchen das Stellenagebot gilt. Mindestens eine Branche muss angegeben werden.
`job_level_category_ids`	Integer Array	Für welche Berufslevel das Stellenagebot gilt. Mindestens ein Berufslevel muss angegeben werden.
`work_schedule_category_ids`	Integer Array	Für welche Zeitformen das Stellenagebot gilt. Mindestens eine Zeitform muss angegeben werden.
`title`	String	Titel des Stellenangebots. Die maximal Länge beträgt 85 Zeichen.
`description`	String	Stellenbeschreibung in Markdown oder HTML formatiert. Die maximal Länge beträgt 2100 Zeichen.
`location`	String	Der öffentlich sichtbare Standort der Stelle. Die maximal Länge beträgt 60 Zeichen.
`geographic_location`	String	Der geographische Standort für die Ermittlung der Koordinaten.
`latitude`	String	Koordinaten für die geographische Sortierung.
`longitude`	String	Koordinaten für die geographische Sortierung.
`is_active`	Boolean	Ist das Stellenangebot aktiv.
`salary`	Number	Grundgehalt der ausgeschriebenen Stelle.
`working_hours`	String	Angaben zu den Arbeitszeiten / Stunden.
`runtime_starts_on`	Timestamp	Der Tag mit dem die Schaltung des Stellenangebots beginnen soll.
`runtime_ends_on`	Timestamp	Der Tag mit dem die Schaltung des Stellenangebots enden soll.

Die API stellt sicher, dass alle Parameter in der Anfrage enthalten sind bzw. keine unerlaubten Parameter mitgesendet wurden. Sollte solch ein Fall eintreten, gibt es entsprechende Fehler.

Die Parameter location, geographic_location, latitude und longitude erfordern besondere Aufmerksamkeit. In der Jobaktuell Jobbörse können Jobsuchende Ihren Standort angeben um zu sehen welche Stellenangebote am nähesten sind. Um diese Sortierung basierend auf der Distanz zwischen zwei Punkten durchführen zu können muss Jobaktuell den geographischen Standort jeder Stelle kennen. Dieser Standpunkt wird in geographischen Koordinaten angegeben.

Neben dem geographischen Standort gibt es auch noch den öffentlich sichtbaren Standort der in dem Stellenangebot aufscheint. Hier gibt es bewusst zwei Angaben für den Standort. So ist es zum Beispiel möglich als Standort nur “Raum Salzburg Stadt” anzugeben und beim geographischen Standort ganz explizit die Adresse des Firmensitzes anzugeben so das die Sortierung nach Distanz möglichst genau ist.

Für das Festlegen des Standortes gibt es drei Möglichkeiten:

Die Anfrage enthält alle vier standortbezogenen Parameter mit entsprechenden Daten. In diesem Fall übernimmt die API die Daten eins zu eins und verändert nichts.
Die Anfrage enthält keine Parameter für die Koordinaten. In diesem Fall verwendet die API die geographic_location um die Koordination selbstständig zu ermitteln. Je spezifischer dieser Parameter ist, desto genauer lassen sich die Koordinaten ermitteln. Da der geographische Standort nicht öffentlich ist, kann hier durchaus eine Postadresse mit Straße, Hausnummer etc. mitgesendet werden.
Die Anfrage enthält nur den Parameter location. In diesem Fall wird dieser Parameter automatisch auch als geographic_location Parameter und somit für die Ermittlung der Koordinaten verwendet.

Stellenangebot aktualisieren

Definition

PUT https://www.jobaktuell.eu/api/v1/company/job-positions/:id

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions/11' \
  -X 'PUT' \
  -u ':api_token' \
  -d 'job_position[description]=Erfahrung mit automatisierten Tests und Ruby erwünscht.'

Beispiel: JSON Antwort

{
  "job_position": {
    "id": 11,
    "company_id": 3,
    "title": "EntwicklerIn",
    "slug": "entwicklerin",
    "location": "Salzburg",
    "description": "Erfahrung mit automatisierten Tests und Ruby erwünscht.",
    "geographic_location": "Salzburg Hbf",
    "latitude": "47.813052",
    "longitude": "13.045071",
    "is_active": true,
    "salary": 40000,
    "working_hours": "38 Wochenstunden",
    "runtime_starts_on": "2016-12-01",
    "runtime_ends_on": "2016-12-31",
    "job_category_ids": [1],
    "job_level_category_ids": [1],
    "work_schedule_category_ids": [1],
    "created_at": "2015-07-30T12:32:34.532+02:00",
    "updated_at": "2015-07-30T18:21:55.233+02:00"
  }
}

Über diesen API-Endpunkt kann ein bestehendes Stellenangebot des Unternehmens aktualisiert werden. Bei Erfolg enthält die Antwort das aktualisierte Stellenangebot. Im Vergleich zum Erstellen eines neuen Stellenangebotes enthält die URL der Anfrage die id des Stellenangebotes und verwendet das HTTP-Verb PUT.

Die Parameter sowie die Handhabung des geographischen Standortes laufen wie beim Erstellen eines neuen Stellenangebotes ab. Ein häufiger Fehler beim Aktualisieren eines Stellenangebotes ist das Mitsenden des Parameters id. Das ist zum einen überflüssig (id ist bereits in der URL vorhanden) und zum anderen nicht erlaubt, da id grundsätzlich unveränderlich ist.

In der Anfrage müssen nur die Attribute als Parameter enthalten sein die aktualisiert werden sollen. Attribute, die sich nicht verändern sollen, können einfach weggelassen werden.

Die Attribute id, created_at und updated_at können nicht über die API verändert werden.

Stellenangebot löschen

Definition

DELETE https://www.jobaktuell.eu/api/v1/company/job-positions/:id

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions/11' \
  -X 'DELETE' \
  -u ':api_token'

Über diesen API-Endpunkt kann ein bestehendes Stellenangebot des Unternehmens zu gelöscht werden. Bei Erfolg gibt es eine leere Antwort mit dem Status Code 204.

Wenn ein Stellenangebot nur kurzfristig nicht mehr inseriert werden soll, muss es nicht gelöscht werden. In diesem Fall ist es besser das Stellenangebot zu aktualisieren und is_active auf false zu setzen. Dadurch verschwindet das Stellenangebot aus der Jobaktuell Jobbörse und kann bei Bedarf später reaktiviert werden.

Stellenangebote auflisten

Definition

GET https://www.jobaktuell.eu/api/v1/company/job-positions

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions' \
  -u ':api_token'

Beispiel: JSON Antwort

{
  "job_positions": [
    {
      "id": 11,
      "company_id": 3,
      "title": "EntwicklerIn",
      "slug": "entwicklerin",
      "location": "Salzburg",
      "description": "Erfahrung mit automatisierten Tests und Ruby erwünscht.",
      "briefing_for_applicants": "Gut vorbereiten.",
      "geographic_location": "Salzburg Hbf",
      "latitude": "47.813052",
      "longitude": "13.045071",
      "is_active": true,
      "salary": 40000,
      "working_hours": "38 Wochenstunden",
      "runtime_starts_on": "2016-12-01",
      "runtime_ends_on": "2016-12-31",
      "job_category_ids": [1],
      "job_level_category_ids": [1],
      "work_schedule_category_ids": [1],
      "created_at": "2015-07-30T12:32:34.532+02:00",
      "updated_at": "2015-07-30T18:21:55.233+02:00"
    }
  ]
}

Über diesen API-Endpunkt können alle Stellenangebote des Unternehmens abgefragt werden. Die JSON Antwort hat auf der ersten Ebene das Attribut job_positions, welches ein Array aller Stellenangebote beinhaltet. Jedes Element dieses Arrays ist eine eigenes Stellenangebot.

Stellenangebot abfragen

Definition

GET https://www.jobaktuell.eu/api/v1/company/job-positions/:id

Beispiel: Anfrage

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions/11' \
  -u ':api_token'

Beispiel: JSON Antwort

{
  "job_position": {
    "id": 11,
    "company_id": 3,
    "title": "EntwicklerIn",
    "slug": "entwicklerin",
    "location": "Salzburg",
    "description": "Erfahrung mit automatisierten Tests und Ruby erwünscht.",
    "briefing_for_applicants": "Gut vorbereiten.",
    "geographic_location": "Salzburg Hbf",
    "latitude": "47.813052",
    "longitude": "13.045071",
    "is_active": true,
    "salary": 40000,
    "working_hours": "38 Wochenstunden",
    "runtime_starts_on": "2016-12-01",
    "runtime_ends_on": "2016-12-31",
    "job_category_ids": [1],
    "job_level_category_ids": [1],
    "work_schedule_category_ids": [1],
    "created_at": "2015-07-30T12:32:34.532+02:00",
    "updated_at": "2015-07-30T18:21:55.233+02:00"
  }
}

Über diesen API-Endpunkt kann ein einzelnes Stellenangebot des Unternehmens abgefragt werden.

Formate

Ausgabe Format

Alle Anfragen an die API werden im JSON Format beantwortet. Das trifft auch auf eventuelle Fehler zu.

Parameter

curl Beispiel mit URL-Kodierung

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions/11' \
  -X 'PUT' \
  -u ':api_token' \
  -d 'job_position[title]=EntwicklerIn'

curl Beispiel mit JSON Format

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions/11' \
  -X 'PUT' \
  -H 'Content-Type: application/json' \
  -u ':api_token' \
  -d '{ "job_position": { "title": "EntwicklerIn" } }'

Bei POST oder PUT Anfragen werden in der Regel Daten an die API gesendet. Die API akzeptiert die Parameter im JSON Format sowie in URL-Kodierung.

Bei der Variante URL-Kodierung müssen die Parameter unter dem Namen job_position verschachtelt sein. Der Parameter title würde zum Beispiel so aussehen: job_position[title]=EntwicklerIn.

Wenn JSON als Format verwendet wird, erwartet sich die API ein JSON-Objekt mit dem Attribut job_position. Innerhalb dieses Attributes befinden sich die einzelnen Parameter: { "job_position": { "title": "EntwicklerIn" } }. Zusätzlich muss die HTTP-Anfrage den Header Content-Type: application/json beinhalten.

HTTP-Verben

Beispiel: Löschen eines Stellenangebots via POST

curl 'https://www.jobaktuell.eu/api/v1/company/job-positions/11' \
  -X 'POST' \
  -H 'X-HTTP-Method-Override: DELETE' \
  -u ':api_token'

Für das Löschen und Aktualisieren eines Stellenangebots sind die HTTP-Verben DELETE und PUT vorgesehen. Sollte es nicht möglich sein diese zu verwenden, kann auf POST zurückgegriffen werden.

Falls POST verwendet wird, muss der entsprechende Header X-HTTP-Method-Override gesetzt sein.

Fehler

Beispiel Antwort mit Fehlern

{
  "errors": [
    {
      "type": "resource_not_found",
      "message": "The requested resource 'job_position' with ID '2234' could not be found. List all with GET /api/v1/company/job-positions",
      "link": "https://www.jobaktuell.eu/api-dokumentation#fehler"
    }
  ]
}

resource_not_found

Das per id in der URL angegebene Stellenangebot konnte nicht gefunden werden. Das kann daran zum Beispiel liegen, dass das Stellenangebot in der Zwischenzeit gelöscht wurde. Eine weitere mögliche Ursache ist, dass mit dem verwendeten API-Token der Zugriff auf das Stellenangebot nicht erlaubt ist.

unknown_association

Beim Erstellen oder Aktualisieren eines Stellenangebotes ist eine Branchen id angeben worden, zu der es keine Branche gibt.

unpermitted_parameter

Beim Erstellen oder Aktualisieren eines Stellenangebotes wurden Parameter mitgesendet, die von der API nicht erlaubt sind. Oft kann das zum Beispiel die id oder einer der Zeitstempel sein.

missing_location

Beim Erstellen oder Aktualisieren eines Stellenangebotes wurden nicht ausreichend Parameter mitgesendet um die Koordinaten des Standortes zu ermitteln.

location_not_found

Beim Erstellen oder Aktualisieren eines Stellenangebotes konnten zu den angegebenen Parametern location und geographic_location keine Koordinaten ermittelt werden. Es kann versucht werden durch Variieren des Parameters geographic_location eine Eingabe zu finden, zu dem Koordinaten ermittelt werden können.

locating_failed

Beim Erstellen oder Aktualisieren eines Stellenangebotes kam es zu einem Fehler beim Versuch die Koordinaten zu ermitteln. Das hat in den meisten Fällen nichts mit den Parametern zu tun sondern damit, dass ein externer Service der API ein Problem hat. In diesem Fall hilft meist eine erneute Anfrage mit den selben Parametern um das Problem zu lösen.

failed_validation

Beim Erstellen oder Aktualisieren eines Stellenangebotes hat ein oder mehrere Parameter nicht den Angaben der API entsprochen. Meist wurden die maximalen Längen von title, location und description überschritten.