bundesAPI / bundesAPI/jobsuche-api

Update Arbeitsagentur API Integration for Current V6 and V4 Response Schemas

Open
#69 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
153
Forks
23
PR merge metrics
No merged PRs in 30d

Description

Arbeitsagentur Jobsuche API differs from the official OpenAPI documentation and the current integration.

## Observed behaviour

Endpoint `GET /pc/v6/jobs` does return key
```
{
ergebnisliste: []
}
```

## Expected

from documentation to return a key `stellenangebote` but this is missing

Also i detected difference in other fields as well:

| Documented | Actual |
|---|---|
| `stellenangebote` | `ergebnisliste` |
| `refnr` | `referenznummer` |
| `titel` | `stellenangebotsTitel` |
| `arbeitgeber` | `firma` |
| `aktuelleVeroeffentlichungsdatum` | `datumErsteVeroeffentlichung` |
| `arbeitsort` | `stellenlokationen` |
| `modifikationsTimestamp` | `aenderungsdatum` |

The V4 detail endpoint is available and returns `HTTP 200`:

```text
GET /pc/v4/jobdetails/{base64(refnr)}
```

However, it also uses different field names:

| Documented | Actual |
|---|---|
| `titel` | `stellenangebotsTitel` |
| `refnr` | `referenznummer` |
| `arbeitsorte` | `stellenlokationen` |
| `aktuelleVeroeffentlichungsdatum` | `datumErsteVeroeffentlichung` |
| `modifikationsTimestamp` | `aenderungsdatum` |
| `stellenbeschreibung` | `stellenangebotsBeschreibung` |

Expected Behaviour:
- Documentation and actual api follow same structure & schema

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by inspecting the integration paths for GET /pc/v6/jobs and GET /pc/v4/jobdetails/{base64(refnr)}, then compare their response mappings with the documented schemas. Done means both endpoints are represented consistently using the actual field names listed, and the documentation matches the returned structures.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi, python
Domain
api, backend
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.