Für Agenten & Entwickler

Dieses Portal stellt zwei öffentliche Fähigkeiten programmatisch bereit, damit KI-Agenten und Tools sie nutzen können: Tauschchancen abfragen (lesen, ohne Anmeldung) und ein Studienplatztausch-Gesuch einreichen (schreiben, per E-Mail-Double-Opt-in abgesichert).

Maschinenlesbare Beschreibungen

/openapi.json — OpenAPI 3.1 Spezifikation
/.well-known/agent-card.json — A2A Agent Card
/llms.txt — Navigationsindex für LLMs

1. Tauschchancen abfragen (GET, ohne Auth)

Ohne Parameter liefert der Endpunkt die gültigen Universitäten und Studienphasen. Mit von und nach liefert er eine Chancen-Bewertung (1–3 Sterne) aus echten Tauschgesuchen.

GET /api/chancen.php?von=Uni%20Bonn&nach=LMU%20M%C3%BCnchen&phase=1.%20klinischen

Antwort (gekürzt):

{
  "ok": true,
  "von": "Uni Bonn",
  "nach": "LMU München",
  "sterne": 1,
  "einschaetzung": "Sehr schwer, plane Alternativen ein",
  "nachfrage_wunschuni": 144,
  "angebot_wunschuni": 7,
  "direkte_tauschpartner": 0
}

2. Tauschgesuch einreichen (POST)

Reicht ein Gesuch ein (Humanmedizin, Zahnmedizin oder Tiermedizin). Wichtig: Das Gesuch wird nicht sofort aktiv. An die angegebene E-Mail geht eine Bestätigungsmail; erst nach Klick auf den Link durch den Menschen wird es aktiv (Double-Opt-in). Ein Agent kann ein Gesuch also anstoßen, aber nicht ohne die Bestätigung der Person aktivieren. vorname, nachname, email, ist_uni, phase, zeitpunkt, wunsch (mindestens eine) und datenschutz: true sind Pflicht; studiengang ist optional (Vorgabe Humanmedizin). Je E-Mail-Adresse ein Gesuch pro Tauschzeitpunkt. Rate-Limit: 4 pro Stunde und IP, 4 pro Tag und E-Mail-Adresse.

POST /api/gesuch.php
Content-Type: application/json

{
  "vorname": "Anna",
  "nachname": "Beispiel",
  "email": "[email protected]",
  "studiengang": "Humanmedizin",
  "ist_uni": "Uni Bonn",
  "phase": "1. klinisches Semester",
  "zeitpunkt": "Wintersemester 2026/2027",
  "wunsch": ["LMU München", "Uni Köln"],
  "datenschutz": true
}

Gültige Werte für ist_uni, wunsch, phase und zeitpunkt hängen vom studiengang ab; die vollständige Spezifikation liefert /openapi.json.

Grenzen & Fairness

Die Schreib-Schnittstelle ist bewusst nur zum Einreichen da — sie liest keine fremden Gesuche aus und gibt keine Personendaten zurück.
Bitte nur echte, vom Menschen gewollte Gesuche einreichen.
Kontakt bei Fragen: [email protected]