profession/alternatives

Führt mittels verschiedener Filtermöglichkeiten eine alternative Berufesuche durch.

Request

Endpoint: POST https://bankathon.fb-xpert.fb-preview.de/external/profession/alternatives

Schema: GET https://bankathon.fb-xpert.fb-preview.de/external/profession/alternatives/request/schema

Validation: POST https://bankathon.fb-xpert.fb-preview.de/external/profession/alternatives/validate


property default description options
[ token ] * required
string
Ein gültiger Token für die Authentifizierung mit der Schnittstelle.
[ company_id ] * required
int
Gesellschafts-IDs
[ designation ] * required
string
Suchbegriff
[ gender ] * required
string
female
Geschlecht
Value Label
male männlich
female weiblich
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "company_id": 1001,
    "designation": "Fachinformatiker für Anwendungsentwicklung",
    "gender": "female"
}
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "company_id": 1001,
    "designation": "Fachinformatiker für Anwendungsentwicklung",
    "gender": "female"
}

Response

Schema: GET https://bankathon.fb-xpert.fb-preview.de/external/profession/alternatives/response/schema


property description options
[ status ] * required
string
Status des Aufrufs
OK: Anfrage erfolgreich
ERROR: Anfrage verlief fehlerhaft
[ errors ]
string[]
Aufgetretene Fehler (wird nur bei "status: ERROR" gefüllt)

object[]
Ergebnis der Berufesuche
property description options
professions[ company_id ] * required
int
ID der Gesellschaft
professions[ designation ] * required
string
genaue Berufsbezeichnung nach der Gesucht wurde
example:

mime-type: application/json, text/json

{
    "status": "OK",
    "errors": [
        "Bitte geben Sie eine gültige Telefonnummer ein."
    ],
    "professions": [
        {
            "company_id": 12345,
            "designation": "Fachinformatiker Anwendungsentwicklung"
        }
    ]
}