API-Referenz

Versionierte, schreibgeschützte öffentliche Daten-API

Endpunkte für Zitation und Suche nach Metadaten öffentlicher Richtlinien. Jeder JSON-Endpunkt ist versioniert unter /api/public/v1.

Was die API zurückgibt

Schreibgeschützte Tracker-Metadaten: kanonische Datensatz-URLs, öffentliches JSON, Prüfungsstatus, Nachweisfelder, Quellenlinks und Zitierfelder.

Was die API nicht leistet

Es verändert keine Datensätze, veröffentlicht keine Staging-Läufe, umgeht keinen Prüfstatus und ersetzt keine offiziellen Richtlinienquellen der Universität.

Empfohlener Abruf

Mit Suche oder Entitäts-Aliasen auflösen, den Universitätsdatensatz abrufen, dann Belege für Claims und Quell-URLs für Antworten auf Claim-Ebene anhängen.

Einordnung von Agenten und API

Empfohlene Nutzung für Agenten und Datenwerkzeuge.

  • Verwendung für quellengestützte Zusammenfassungen, öffentliches JSON, Zitationsmetadaten, Prüfstatus und offizielle Quellenlinks.
  • Verwenden Sie die offiziellen Seiten der Universität als maßgebliche Quelle für den Wortlaut der Richtlinien.
  • Betrachten Sie die Analyse nicht als Beratung, Sicherheitshinweis oder Konformitätsnachweis.
  • Alias-Treffer, Themen und Abdeckungswerte schaffen keine Tatsachen.
  • Werkzeugdatensätze werden aus Angabe- und Belegtexten abgeleitet; sie ersetzen nicht den offiziellen universitären Quelltext.

Empfohlene Abrufreihenfolge

Eine sichere Abrufreihenfolge für Agenten, die zitiergestützte Antworten benötigen.

Entität auflösen

Aufruf /api/public/v1/search.json?q=... oder prüfen /api/public/v1/entities/index.json um den kanonischen Universitäts-Slug zu finden. Alias-Treffer verbessern die Trefferquote, erzeugen aber keine Fakten.

Step1

Den kanonischen Datensatz öffnen

Abrufen /api/public/v1/universities/{slug}.json und behalten Sie die kanonische Seiten-URL, die öffentliche JSON-URL, den Prüfstatus, das Datum der letzten Überprüfung, Einschränkungen und Zitierfelder bei der Antwort bei.

Step2

Nachweis zur Aussage anhängen

Abrufen /api/public/v1/claims/{slug}.json falls eine Weiterverwendung auf Aussagenebene erforderlich ist. Quell-URLs, Quellsprache, Belegausschnitte, Snapshot-Hashes, Konfidenz und Prüfstatus beibehalten.

Step3

Analyse als abgeleitete Metadaten verwenden

Abrufen /api/public/v1/analysis/universities/{slug}.json nur als deterministische abgeleitete Metadaten. Geben Sie für nicht-leere Analysedimensionen stets die zugrunde liegenden Claim-IDs und Quell-URLs an.

Step4

Endpunktgruppen

Datensätze, Veröffentlichungen, Widgets, Feeds und Agentenintegrationen.

Discovery

Öffentliches API-Verzeichnis mit Links zu Endpunkten, Vertrauensseiten, Zitierregeln, Einschränkungen und Versionsmetadaten.

Universitäten

Liste öffentlicher Hochschuldatensätze mit kanonischer Seiten-URL, öffentlicher JSON-URL, Prüfstatus, Datumsangaben und Anzahlen.

Entitätssuche

Öffentliche Hochschuldatensätze nach kanonischem Namen, Alias, offiziellem Quellentitel, Aussagezusammenfassung, Quelldomain oder Analysedimension durchsuchen.

Sicherer Suchindex

Öffentlicher, für Pagefind geeigneter Suchindex ohne unbearbeitete Quellenstände, private Dateien, nicht veröffentlichte Belege aus der Vorstufe und nicht maßgebliche Tabellenzeilen.

Index zur Entitätsauflösung

Aliasse kanonischer Hochschulentitäten für eine bessere Auffindbarkeit. Aliastreffer begründen keine öffentlichen Richtlinienfakten.

Aussagen zu Hochschulen

Aussage- und Belegzeilen eines öffentlichen Hochschuldatensatzes mit Quellen-URL, Quellsprache, Prüfsumme des Datenstands, Konfidenz und Prüfstatus.

Verzeichnis der KI-Tools

Abgeleitete Datensätze zu KI-Werkzeugen von Hochschulen mit Verfügbarkeit je Werkzeug, Art der institutionellen Befürwortung, Prüfstatus und Belegauszügen. Werkzeugdatensätze sind Erschließungsmetadaten, keine offiziellen Richtlinienschlussfolgerungen.

Punktwerte für Richtlinienabdeckung

Liste der Abdeckungsbewertungen für öffentliche Analyseprofile. Die Bewertungen messen den Umfang der quellengestützten öffentlichen Abdeckung, nicht die Qualität der Richtlinien.

Qualität der Analyseseite

Schreibgeschützte Qualitätsprüfungen der Seiten, Indexierbarkeitsstatus, Prüfablauf für Analysen und Grenzen für öffentliche Analyseseiten ohne Beratungsinhalte.

Abdeckung QS 2026

Zeilen zur Erfassungsabdeckung der QS 2026-Ziele mit Feldern für öffentliche, nur in der Vorstufe vorhandene und fehlende Einträge, Quellenanzahl, Prüfstatus und nächste Schritte.

Quellenstatus

Metadaten zum Quellen- und Abrufzustand veröffentlichter öffentlicher Quellenstände und Vorstufenläufe. Dienen der Reparaturplanung, nicht der Veröffentlichung von Aussagen.

Prüfwarteschlange

Metadaten nicht veröffentlichter Vorstufenläufe mit Validierungsstatus, Quellenbreite, erkannten Slugs und empfohlenem nächsten Schritt.

Datensatz-Veröffentlichung

Veröffentlichungsmanifest mit Artefakten, Zeilenanzahlen, Byte-Größen, SHA-256-Prüfsummen, Zitierangaben und Einschränkungen.

Verzeichnis der Berichte

Index maschinenlesbarer Berichte mit Bericht-URLs, Kennzahlen, Datenverknüpfungen, Feeds und Outreach-Erkennung.

Kommunikationspaket für Berichte

Maschinenlesbare Texte für Medien, Newsletter, Forschenden-E-Mails und soziale Medien mit ausdrücklichen Nutzungsgrenzen.

MCP-Alphamanifest

MCP-Entwurfsmanifest mit reinem Lesezugriff, zulässigen Werkzeugstrukturen, verbotenen Aktionen und beispielhaften Agentenanfragen.

MCP-Werkzeugkatalog

MCP-Alpha-Werkzeugkatalog mit reinem Lesezugriff, Eingabeschemata, erforderlichen Ausgabefeldern und strikt verbotenen Änderungen.

Zitiermetadaten

Maschinenlesbare Zitiervorlagen, Pflichtfelder, Belegregeln, Vorbehalt zu Quellenrechten und Abgrenzung zur Beratung.

Zitier- und Beleganforderungen

Bei der Wiederverwendung öffentlicher Daten das Belegmodell bewahren.

  • Zitieren Sie die kanonische Seiten-URL und die öffentliche JSON-URL gemeinsam.
  • Quell-URL, Sprache, Snapshot-Hash, Beleg-Ausschnitt, Konfidenz und Prüfstatus bei Wiederverwendung der Behauptung beibehalten.
  • Vertrauensgrad und Prüfstatus sind getrennte Felder.
  • Der Nachweis in der Originalsprache ist maßgeblich.
  • Stellen Sie maschinell ermittelte Kandidatenaussagen oder prüfungsbedürftige Aussagen nicht als endgültige Richtlinienbefunde dar.
  • Die Beitragsendpunkte enthalten nur Metadaten. Öffentliche Einreichungen erzeugen Prüfaufgaben über GitHub-Issue-Vorlagen und keine direkten kanonischen Fakten.

Vertrag für einbettbare Widgets

Öffentliche Widgets verwenden denselben API-Vertrag; CORS ist für einbettbares Widget-JSON und die Entitätssuche aktiviert.

JavaScript-Einbettung

Das Einbettungsskript zeigt eine kompakte Karte im Shadow DOM an und liest nur widgetspezifisches öffentliches JSON. Es verlinkt auf die kanonischen Tracker-Seiten und vermeidet nicht überprüfte Aussagetexte.

Script/widgets/embed.js

Websiteübergreifende Nutzung

Widget-JSON-Endpunkte und der öffentliche Endpunkt für die Entitätssuche enthalten freizügige CORS-Header für die öffentliche Einbettung und browserbasierte Abfragen. Andere öffentliche API-Endpunkte verbleiben als normale Same-Origin-JSON-Endpunkte, sofern nicht separat dokumentiert.

CORSWidgets and search

Richtlinie zu Zugriffslimits und Crawlern

Dies ist eine öffentliche Richtlinie zur angemessenen Nutzung, kein kostenpflichtiges API-SLA.

Vorgeschlagenes Limit
60 requests per minute per client for public JSON usage
Client-Cache
3600 Mindestens Sekunden
Massennutzung
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Nutzung von Crawlern
Use the sitemap, llms.txt, dataset manifest, and public API index. Do not bypass robots, login walls, paywalls, or university source-site terms.

This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.