← Zur Startseite

Für Agenten & Entwickler

Dieses Portal stellt zwei öffentliche Hauptfä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). Die OpenAPI-Spezifikation beschreibt dazu drei weitere lesende Endpunkte (Chancen-Daten, Inseratsliste und Ticker), insgesamt fünf Pfade.

Maschinenlesbare Beschreibungen

1. Tauschchancen abfragen (GET, ohne Auth)

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

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

Antwort (gekürzt, Beispielwerte):

{
  "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": "anna@example.com",
  "studiengang": "Humanmedizin",
  "ist_uni": "Uni Bonn",
  "phase": "5. Fachsemester",
  "zeitpunkt": "Sommersemester 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. Das Feld phase ist das Fachsemester: „1. Fachsemester“ bis „10. Fachsemester“ plus „Praktisches Jahr“ (Humanmedizin), 1. bis 10. Fachsemester (Zahnmedizin), 1. bis 11. Fachsemester (Tiermedizin). Ältere Werte wie „1. klinisches Semester“ oder bei Zahn- und Tiermedizin „7. Semester“ nehmen wir weiterhin an und rechnen sie um; Antworten nennen nur die neuen Werte.

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]