Bewerberkommunikation
2 endpoints
Kommunikationseinträge zu einem Bewerber anlegen und mit Anhängen versehen.
Gedacht für Systeme, die eigene Korrespondenz führen — etwa ein Mailsystem oder ein Messenger — und diese in talent.Flow sichtbar machen wollen, damit die Historie am Bewerber vollständig bleibt.
Kommunikation anlegen
POST /candidates/{candidateId}/communications
Mit diesem Endpunkt kann eine Kommunikation für einen Kandidaten angelegt werden.
Es wird die KandidatenId benötigt, welche beim Anlegen der Stammdaten zurück gegeben wird.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
candidateId |
path | integer | yes | Identifikation des Bewerbers |
Request body
Content type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
userId |
integer (int32) | null | no |
eventDateTimeUtc |
string (date-time) | null | no |
headline |
string | null | no |
communicationKindId |
CommunicationKind | no | Art der Kommunikation |
communicationStatus |
CommunicationStatus | no | Status der Kommunikation |
note |
string | null | no |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
id |
integer (int32) | no | Eindeutige Identifikation des erzeugten Datensatzes |
400 — Ungültige Anfrage oder Validierungsfehler
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
404 — Bewerber nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
Anhang zur Kommunikation hinzufügen
POST /candidates/{candidateId}/communications/{id}/attachments
Mit diesem Endpunkt kann ein Anhang für eine Kommunikation für einen Kandidaten angelegt werden.
Es wird die KandidatenId benötigt, welche beim Anlegen der Stammdaten zurück gegeben wird.
Es wird die KommunikationsId benötigt, welche beim Anlegen der Kommunikation zurück gegeben wird.
Die Datei muss als Base64 String übergeben werden.
Der 'Base64EncodedString' muss das Format ''data:mimetype;base64,base64String' haben.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
candidateId |
path | integer | yes | Identifikation des Bewerbers |
id |
path | integer | yes | Identifikation des Bewerbers |
Request body
Content type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
fileName |
string | null | no |
data |
string | null | no |
createdAtUtc |
string (date-time) | null | no |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
success |
boolean | no | Gibt an, ob die Operation erfolgreich war |
400 — Ungültige Anfrage oder Validierungsfehler
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
404 — Bewerber oder Kommunikation nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |