Stellenanzeigenübersichten
4 endpoints
Stellenanzeigen auflisten und Änderungen im Zeitraum abrufen.
Liefert die Stammdaten zu den Kennzahlen aus den Stellenanzeigenauswertungen — Titel, Laufzeit und Zuordnung, die eine reine Kennzahlenzeile nicht enthält.
Stellenanzeigen auflisten
GET /jobads
Dieser Endpunkt gibt eine Liste von Stellenanzeigen zurück.
Über die optionalen Query-Parameter startDate und endDate (Format: YYYY-MM-DD) kann die Ausgabe auf einen Zeitraum eingegrenzt werden. Ohne Angabe werden alle Stellenanzeigen zurückgegeben.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
endDate |
query | string | no | Ende des Zeitraums im Format YYYY-MM-DD |
startDate |
query | string | no | Beginn des Zeitraums im Format YYYY-MM-DD |
Responses
200 — OK
Array of:
| Property | Type | Required | Description |
|---|---|---|---|
id |
string (uuid) | no | Eindeutige Identifikation der Stellenanzeige |
status |
string | null | no |
createdAtUtc |
string (date-time) | no | Zeitpunkt der Erstellung (UTC) |
modifiedAtUtc |
string (date-time) | no | Zeitpunkt der letzten Änderung (UTC) |
Stellenanzeigenänderungen nach Zeitraum und Niederlassung
GET /jobads/changes
Dieser Endpunkt gibt die Änderungen der Stellenanzeigen in einem Zeitraum von Tagen zurück.
Die Eigenschaft "ProcessStatus" gibt den aktuellen Zustand der Stellenanzeige an.
Die Stellenanzeige kann folgende Zustände einnehmen
Editing: Die Stellenanzeige ist noch im Entwurf und nicht veröffentlicht.
Active: Die Stellenanzeige ist auf bewerbungs.jobs veröffentlicht und kann auf anderen Plattformen ausgespielt werden
Completed: Die Stellenanzeige wurde aus bewerbung.jobs entfernt und kann nicht mehr auf anderen Plattformen ausgespielt werden
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
endDate |
query | string | no | Ende des Zeitraums im Format YYYY-MM-DD |
officeId |
query | integer | no | Identifikation der Niederlassung |
startDate |
query | string | no | Beginn des Zeitraums im Format YYYY-MM-DD |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
new |
JobAdChangesDetailsDto[] | no | Neue Stellenanzeigen |
modified |
JobAdChangesDetailsDto[] | no | Bearbeitete Stellenanzeigen |
deleted |
JobAdChangesDetailsDto[] | no | Gelöschte Stellenanzeigen |
Stellenanzeigenänderungen pro Tag
GET /jobads/changes/{date}
Dieser Endpunkt gibt die Änderungen der Stellenanzeigen pro Tag zurück.
Die Eigenschaft "ProcessStatus" gibt den aktuellen Zustand der Stellenanzeige an.
Die Stellenanzeige kann folgende Zustände einnehmen
Editing: Die Stellenanzeige ist noch im Entwurf und nicht veröffentlicht.
Active: Die Stellenanzeige ist auf bewerbungs.jobs veröffentlicht und kann auf anderen Plattformen ausgespielt werden
Completed: Die Stellenanzeige wurde aus bewerbung.jobs entfernt und kann nicht mehr auf anderen Plattformen ausgespielt werden
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
date |
path | string | yes | Stichtag im Format YYYY-MM-DD |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
new |
JobAdChangesDetailsDto[] | no | Neue Stellenanzeigen |
modified |
JobAdChangesDetailsDto[] | no | Bearbeitete Stellenanzeigen |
deleted |
JobAdChangesDetailsDto[] | no | Gelöschte Stellenanzeigen |
404 — Stellenanzeige nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
Stellenanzeigenänderungen pro Tag und Stunde
GET /jobads/changes/{date}/{hour}
Dieser Endpunkt gibt die Änderungen der Stellenanzeigen pro Tag und Stunde zurück.
Die Eigenschaft "ProcessStatus" gibt den aktuellen Zustand der Stellenanzeige an.
Die Stellenanzeige kann folgende Zustände einnehmen
Editing: Die Stellenanzeige ist noch im Entwurf und nicht veröffentlicht.
Active: Die Stellenanzeige ist auf bewerbungs.jobs veröffentlicht und kann auf anderen Plattformen ausgespielt werden
Completed: Die Stellenanzeige wurde aus bewerbung.jobs entfernt und kann nicht mehr auf anderen Plattformen ausgespielt werden
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
date |
path | string | yes | Stichtag im Format YYYY-MM-DD |
hour |
path | integer | yes | Stunde des Tages (0–23) |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
new |
JobAdChangesDetailsDto[] | no | Neue Stellenanzeigen |
modified |
JobAdChangesDetailsDto[] | no | Bearbeitete Stellenanzeigen |
deleted |
JobAdChangesDetailsDto[] | no | Gelöschte Stellenanzeigen |
404 — Stellenanzeige nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |