profession/search

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

Request

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

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

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


property default description options
[ token ] * required
string
Ein gültiger Token für die Authentifizierung mit der Schnittstelle.
* required
object
Daten, nach denen gefiltert werden soll.
property default description options
filter[ companies ] * required
int[]
Gesellschafts-IDs
filter[ gender ] * required
string
female
Geschlecht
Value Label
male männlich
female weiblich
[ designation ] * required
string
Suchbegriff
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "filter": {
        "companies": [
            1,
            10,
            11,
            100,
            1001
        ],
        "gender": "female"
    },
    "designation": "Fachinformatiker für Anwendungsentwicklung"
}
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "filter": {
        "companies": [
            1,
            10,
            11,
            100,
            1001
        ],
        "gender": "female"
    },
    "designation": "Fachinformatiker für Anwendungsentwicklung"
}

Response

Schema: GET https://bankathon.fb-xpert.fb-preview.de/external/profession/search/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
Gesellschafts-ID
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": 22,
            "designation": "Fachinformatiker Anwendungsentwicklung"
        }
    ]
}