Skip to content

Commit

Permalink
Update to v1.0.1
Browse files Browse the repository at this point in the history
  • Loading branch information
AndreasFischer1985 authored Aug 11, 2024
1 parent 9cd72f9 commit 850e70f
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 40 deletions.
25 changes: 5 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,26 +3,11 @@ Die Bundesagentur für Arbeit verfügt über eine der größten Datenbanken für


## Authentifizierung
Die Authentifizierung funktioniert per OAuth 2 Client Credentials mit JWTs.
Client Credentials sind, wie https://www.arbeitsagentur.de/bewerberboerse/config/config.js zu entnehmen ist, folgende:
Die Authentifizierung funktioniert über die clientId der Bewerberbörse:

**client_id:** 919b0af7-6e5f-4542-a7f5-04268b8bae2e
clientId: jobboerse-bewerbersuche-ui

**client_secret:** 93fce94c-5be2-4dc8-b040-c62818a4b003

**grant_type:** client_credentials

Die Credentials sind im body eines POST-request an https://rest.arbeitsagentur.de/oauth/gettoken_cc zu senden.

```bash
token=$(curl \
-d "client_id=919b0af7-6e5f-4542-a7f5-04268b8bae2e&client_secret=93fce94c-5be2-4dc8-b040-c62818a4b003&grant_type=client_credentials" \
-X POST 'https://rest.arbeitsagentur.de/oauth/gettoken_cc' |grep -Eo '[^"]{400,}'|head -n 1)
```

Der generierte Token muss bei folgenden GET-requests an https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerber im header als 'OAuthAccessToken' inkludiert werden.

**Hinweis:** Alternativ kann man bei folgenden GET-requests auch direkt die *client_id* als Header-Parameter *'X-API-Key'* übergeben - *'OAuthAccessToken'* ist in diesem Fall nicht erforderlich. 🚀
Bei folgenden GET-requests ist die clientId als Header-Parameter 'X-API-Key' zu übergeben.


## Bewerbendenbörse
Expand Down Expand Up @@ -121,7 +106,7 @@ Anzahl der Ergebnisse

```bash
bewerbende=$(curl -m 60 \
-H "OAuthAccessToken: $token" \
-H "X-API-Key: jobboerse-bewerbersuche-ui" \
'https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerber?angebotsart=ar&wo=Feucht&umkreis=0&page=0&size=25')
```

Expand All @@ -138,6 +123,6 @@ u.a. Bildungshistorie, beruflicher Werdegang, Lizenzen, Kenntnisse & Skills.

```bash
bewerbendendetails=$(curl -m 60 \
-H "OAuthAccessToken: $token" \
-H "X-API-Key: jobboerse-bewerbersuche-ui" \
'https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerberdetails/10005-955011998040991647-B')
```
11 changes: 2 additions & 9 deletions api_example.R
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,10 @@
#----------------
install.packages(c("devtools","jsonlite","httr"))
devtools::install_github("AndreasFischer1985/qqBaseX")
clientId="919b0af7-6e5f-4542-a7f5-04268b8bae2e"
clientSecret="93fce94c-5be2-4dc8-b040-c62818a4b003"
clientId="jobboerse-bewerbersuche-ui"

postData=list( "grant_type"="client_credentials","client_id"=clientId,"client_secret"=clientSecret)
token_request=httr::POST(
url="https://rest.arbeitsagentur.de/oauth/gettoken_cc",
body=postData,encode="form",
config=httr::config(connecttimeout=60))
token=httr::content(token_request, as='parsed')$access_token
url="https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerber?angebotsart=ar"
data_request=httr::GET(url=url, httr::add_headers(.headers=c("OAuthAccessToken"=token)),
data_request=httr::GET(url=url, httr::add_headers(.headers=c("X-API-Key"=clientId)),
config=httr::config(connecttimeout=60))
data_request
data=httr::content(data_request)
Expand Down
19 changes: 8 additions & 11 deletions openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,13 @@ info:
title: "Arbeitsagentur Bewerberbörse API"
description: |
Eine der größten Datenbanken für Bewerbende in Deutschland durchsuchen.
Die Authentifizierung funktioniert per OAuth 2 Client Credentials mit JWTs. Folgende Client-Credentials können dafür verwendet werden:
**ClientID:** 919b0af7-6e5f-4542-a7f5-04268b8bae2e
**ClientSecret:** 93fce94c-5be2-4dc8-b040-c62818a4b003
**Achtung**: der generierte Token muss bei folgenden GET-requests im header als *'OAuthAccessToken'* inkludiert werden. Alternativ kann man bei folgenden GET-requests auch direkt die *client_id* als Header-Parameter *'X-API-Key'* übergeben - *'OAuthAccessToken'* ist in diesem Fall nicht erforderlich. 🚀
version: "1.0.0"
Die Authentifizierung funktioniert über die clientId der Bewerberbörse:
**clientId:** jobboerse-bewerbersuche-ui
Bei folgenden GET-requests ist die clientId als Header-Parameter 'X-API-Key' zu übergeben.
version: "1.0.1"
contact:
name: "AndreasFischer1985"
email: "[email protected]"
Expand Down Expand Up @@ -183,7 +180,7 @@ components:
type: apiKey
in: header
name: X-API-Key
description: "X-API-Key ist die Client-ID 919b0af7-6e5f-4542-a7f5-04268b8bae2e"
description: "X-API-Key ist die Client-ID jobboerse-bewerbersuche-ui"

schemas:
Response:
Expand Down

0 comments on commit 850e70f

Please sign in to comment.