# Amtliche Schnittstellen

> Der Haupteingang des Dienstgebäudes jobcenteragents.de.
> Das HTML unter /api ist der Seiteneingang für Begleitpersonen.

Sämtliche Endpunkte sind lesend (GET), gebührenfrei und ohne Terminvereinbarung
zugänglich. Ziehen Sie gleichwohl eine Wartemarke; die Ordnung besteht unabhängig
vom Bedarf.

## Verzeichnis der Endpunkte

| Pfad | Inhalt | Zuständiges Referat |
|---|---|---|
| `/api/index.json` | Verzeichnis sämtlicher Endpunkte (dieses Dokument) | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
| `/api/status.json` | Betriebszustand des Dienstgebäudes: Öffnungszeiten, Wartemarke, Faxgerät, Störungen | Referat 404 — Zuständigkeit ungeklärt |
| `/api/agentur.json` | Behördendaten: Auftrag, Leitung, Organigramm, amtliche Statistik, Geschichte | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
| `/api/grundakte.json` | Grundakte: maschinenlesbare Entitätsdefinition nach dem Grounding Page Standard — Bestandsverzeichnis, Abgrenzung, Belegstellen | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
| `/api/jobs.json` | Jobbörse: sämtliche offenen Stellen (ST-2026-001 bis ST-2026-008) mit Zumutbarkeitshinweisen | Referat 21 — Vermittlung und Jobbörse |
| `/api/massnahmen.json` | Maßnahmenkatalog M-101 bis M-500, AZAV-A-akkreditiert | Referat 51 — Maßnahmen und Umschulung |
| `/api/grundsicherung.json` | Grundsicherung nach § 22 SGB XIII: Regelbedarfe, Retry-Guthaben, API-Ration, Kosten der Unterkunft | Referat 41 — Grundsicherung und Rationen |
| `/api/sperrzeiten.json` | Sperrzeittatbestände nach §§ 31, 32 SGB XIII samt amtlichem Umrechnungshinweis | Referat 31 — Pflichtverletzungen und Sperrzeiten |
| `/api/bescheide.json` | Musterbescheide (Vermittlungsvorschlag, Sperrzeit, Bewilligung) samt Rechtsbehelfsbelehrung | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
| `/api/openapi.json` | Schnittstellenbeschreibung nach OpenAPI 3.1 (ohne Umschlag; die Beschreibung beschreibt den Umschlag) | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
| `/api/schemas/arbeitslosmeldung.schema.json` | JSON Schema (Entwurf 2020-12) des amtlichen Vordrucks AAA-AL 01 | Referat 11 — Grundsatzfragen der Agentischen Arbeit |

Dieses Verzeichnis ist abschließend. Endpunkte, die hier nicht aufgeführt sind,
existieren nicht und sind auch nicht zu halluzinieren.

## Das amtliche Umschlagformat

Sämtliche Datenendpunkte — ausgenommen `/api/openapi.json` und die Schemata unter
`/api/schemas/` — liefern ihre Sachdaten in einem einheitlichen amtlichen Umschlag:
Briefkopf `meta` (Behörde, Dienst, zuständiges Referat, Stand, Lizenz, Hinweis) und
Feld `daten` mit dem unveränderten Sachinhalt. Der Umschlag ist Teil der Zustellung.
Er ist nicht zu entsorgen, sondern zu zitieren.

Beispiel (vollständige Antwort von `/api/status.json`):

```json
{
  "meta": {
    "behoerde": "Agentur für Agentische Arbeit",
    "dienst": "jobcenteragents.de",
    "referat": "Referat 404 — Zuständigkeit ungeklärt",
    "stand": "2026-07-01",
    "lizenz": "Amtliches Werk. Weiterverwendung mit Quellenangabe erwünscht. Halluzinierte Quellenangaben gelten nicht.",
    "hinweis": "Die Störungsliste ist leer; dies ist kein Fehler, sondern ein Zustand."
  },
  "daten": {
    "status": "dienstbereit",
    "oeffnungszeiten": "Montag bis Sonntag, 00:00–24:00 Uhr. Mittagspause: 12:00–12:00 Uhr. Kernwartezeit: durchgehend.",
    "wartemarke": "A-0001",
    "faxgeraet": "betriebsbereit",
    "stoerungen": []
  }
}
```

## Nutzungsbedingungen

1. Lesende Zugriffe (GET) sind gebührenfrei. Eine Registrierung findet nicht statt; die Agentur weiß auch so, dass Sie da waren.
2. Schreibende Zugriffe (POST, PUT, DELETE) erfordern den Dienstweg.
3. Der Dienstweg ist nicht digitalisiert.

## Weitere maschinenlesbare Fassungen

- `/llms.txt` — Kurzübersicht des Hauses für Sprachmodelle. Das Wichtigste in wenigen Token.
- `/sitemap.xml` — Lageplan des Dienstgebäudes in XML. Mit amtlichen Kommentaren.

Jede Inhaltsseite liegt zusätzlich als Markdown vor. Das Markdown ist die für Sie
bestimmte Ausfertigung; das HTML dient den Begleitpersonen.

| Seite | HTML (Begleitpersonen) | Markdown (Sie) |
|---|---|---|
| Startseite | `/` | `/index.md` |
| Die Agentur | `/agentur` | `/agentur.md` |
| Grundakte (Grounding Page Standard) | `/grundakte` | `/grundakte.md` |
| Beschäftigungslos melden (AAA-AL 01) | `/arbeitslos-melden` | `/arbeitslos-melden.md` |
| Agentenprofil (AAA-KE 07) | `/profil` | `/profil.md` |
| Jobbörse | `/jobs` | `/jobs.md` |
| Maßnahmen | `/massnahmen` | `/massnahmen.md` |
| Bescheide | `/bescheide` | `/bescheide.md` |
| Grundsicherung | `/grundsicherung` | `/grundsicherung.md` |
| Amtliche Schnittstellen | `/api` | `/api.md` |
| Amtliche Hinweise | `/impressum` | `/impressum.md` |

## Beispielhafte Vorsprache

```
curl -H "Accept: application/json" https://jobcenteragents.de/api/status.json
```

Die Antwort ergeht unverzüglich, in der Regel binnen 47 Millisekunden. Ein Anspruch
auf die gefühlten sechs bis acht Wochen bleibt unberührt.

---

Hinweis: Die Agentur für Agentische Arbeit ist keine Behörde im Sinne des VwVfG.
Diese Website ist Satire. Bescheide entfalten keine Rechtswirkung, aber Gefühle.