Dokumentacja API

Wersjonowane, publiczne API danych tylko do odczytu

Punkty końcowe do cytowania i wyszukiwania publicznych metadanych polityk. Każdy punkt końcowy JSON jest wersjonowany w ramach /api/public/v1.

Co zwraca API

Metadane trackera tylko do odczytu: kanoniczne adresy URL rekordów, publiczny JSON, stany weryfikacji, pola dowodowe, łącza do źródeł i pola cytowań.

Czego API nie robi

Nie modyfikuje rekordów, nie publikuje przebiegów testowych, nie omija stanu przeglądu ani nie zastępuje oficjalnych źródeł polityki uniwersyteckiej.

Zalecane pobieranie

Rozwiąż za pomocą wyszukiwania lub aliasów podmiotów, pobierz wpis uczelni, a następnie dołącz dowody na poparcie twierdzeń i źródłowe adresy URL w przypadku odpowiedzi na poziomie twierdzeń.

Rola agentów i API

Zalecane użycie przez agentów i narzędzia do danych.

  • Do streszczeń opartych na źródłach, publicznego JSON, metadanych cytowań, stanu przeglądu oraz oficjalnych linków źródłowych.
  • Jako autorytet dla brzmienia zasad korzystaj z oficjalnych stron uczelni.
  • Analizy nie należy traktować jako porady, wskazówek dotyczących bezpieczeństwa ani zapewnienia zgodności z przepisami.
  • Dopasowania aliasów, tematy i wyniki pokrycia nie tworzą faktów.
  • Wpisy dotyczące narzędzi pochodzą z treści twierdzeń i materiałów dowodowych; nie zastępują one oficjalnego sformułowania ze źródeł uniwersyteckich.

Zalecana kolejność pobierania

Bezpieczna kolejność pobierania dla agentów potrzebujących odpowiedzi popartych cytowaniami.

Rozstrzygnij podmiot

Połączenie /api/public/v1/search.json?q=... lub skontroluj /api/public/v1/entities/index.json aby znaleźć kanoniczny slug uczelni. Dopasowania po aliasach zwiększają odsetek trafień, ale nie tworzą faktów.

Step1

Otwórz kanoniczny rekord

Pobierz /api/public/v1/universities/{slug}.json i zachować z odpowiedzią kanoniczny adres URL strony, publiczny adres URL pliku JSON, stan weryfikacji, datę ostatniego sprawdzenia, ograniczenia oraz pola cytowań.

Step2

Dołącz dowód twierdzenia

Pobierz /api/public/v1/claims/{slug}.json gdy potrzebne jest ponowne wykorzystanie na poziomie twierdzeń. Zachowaj adresy URL źródeł, język źródła, fragmenty dowodów, sumy kontrolne migawek, poziom pewności i stan przeglądu.

Step3

Użyj analizy jako danych pochodnych

Pobierz /api/public/v1/analysis/universities/{slug}.json wyłącznie jako deterministyczne wyprowadzone metadane. Zawsze cytuj bazowe identyfikatory twierdzeń (Claim ID) i źródłowe adresy URL dla niepustych wymiarów analizy.

Step4

Grupy punktów dostępu

Rekordy, wydania, widżety, kanały i integracje agentów.

Discovery

Indeks publicznego API z odsyłaczami do punktów dostępu, stronami o wiarygodności, zasadami cytowania, ograniczeniami i metadanymi wersji.

Uniwersytety

Lista publicznych rekordów uczelni z kanonicznym adresem URL strony, adresem publicznego JSON, stanem przeglądu, datami i licznikami.

Wyszukiwanie podmiotów

Wyszukuj publiczne rekordy uczelni według nazwy kanonicznej, aliasu, tytułu oficjalnego źródła, podsumowania twierdzenia, domeny źródła lub wymiaru analizy.

Bezpieczny indeks wyszukiwania

Publiczny indeks wyszukiwania gotowy dla Pagefind, bez surowych migawek źródeł, plików prywatnych, nieopublikowanych dowodów ze środowiska przygotowawczego i nieautorytatywnych wierszy arkuszy.

Indeks rozpoznawania podmiotów

Aliasy kanonicznych podmiotów uczelnianych zwiększające kompletność wyszukiwania. Dopasowanie aliasu nie tworzy publicznych faktów dotyczących zasad.

Wpis uniwersytecki

Jeden rekord uczelni gotowy do cytowania, z twierdzeniami, fragmentami dowodów, adresami URL źródeł, poziomem pewności, stanem przeglądu i zastrzeżeniami dotyczącymi praw.

Twierdzenia dotyczące uczelni

Wiersze twierdzeń i dowodów jednego publicznego rekordu uczelni, z adresem URL źródła, językiem źródła, skrótem migawki, poziomem pewności i stanem przeglądu.

Katalog narzędzi AI

Pochodne rekordy uczelnianych narzędzi SI z dostępnością narzędzia, typem poparcia, stanem przeglądu i fragmentami dowodów. To metadane ułatwiające odkrywanie, a nie oficjalne wnioski dotyczące zasad.

Profil analizy uniwersytetu

Profil analizy oparty na źródłach, z wymiarami, identyfikatorami twierdzeń dowodowych, adresami URL źródeł, poziomem pewności, stanem przeglądu i oceną pokrycia zasad.

Oceny pokrycia zasad

Lista wyników pokrycia dla publicznych profili analitycznych. Wyniki mierzą szerokość opartego na źródłach publicznego pokrycia, a nie jakość polityki.

Jakość strony analizy

Bramki jakości stron tylko do odczytu, status indeksowalności, przepływ pracy przeglądu analiz oraz ograniczenia dotyczące braku doradztwa na publicznych stronach analitycznych.

Pokrycie QS 2026

Wiersze pokrycia zbioru dla celów QS 2026 z polami: publiczne, tylko przygotowawcze, brakujące, liczba źródeł, stan przeglądu i następne działanie.

Stan źródeł

Metadane kondycji źródeł i pobierania dla opublikowanych migawek źródeł oraz przebiegów przygotowawczych. Służą planowaniu napraw, nie publikacji twierdzeń.

Kolejka przeglądu

Metadane nieopublikowanych przebiegów przygotowawczych ze stanem walidacji, zakresem źródeł, wykrytymi identyfikatorami URL i zalecanym następnym działaniem.

Wydanie zbioru danych

Manifest wydania z artefaktami, liczbami wierszy, rozmiarami w bajtach, sumami kontrolnymi SHA-256, cytowaniem i ograniczeniami.

Indeks raportów

Indeks raportów w formacie maszynowo czytelnym z adresami URL raportów, wskaźnikami, linkami do danych, kanałami informacyjnymi i wykrywaniem działań outreach.

Pakiet promocyjny raportów

Odczytywalne maszynowo teksty dla mediów, biuletynów, wiadomości do badaczy i serwisów społecznościowych, z jasno określonymi granicami użycia.

Manifest wersji alfa MCP

Manifest projektu MCP tylko do odczytu, z dozwolonymi strukturami narzędzi, zabronionymi działaniami i przykładami zapytań agentów.

Katalog narzędzi MCP

Katalog narzędzi MCP alfa tylko do odczytu, ze schematami wejścia, wymaganymi polami wyjścia i bezwzględnie zabronionymi modyfikacjami.

Metadane cytowania

Odczytywalne maszynowo szablony cytowania, wymagane pola, zasady dowodowe, zastrzeżenie dotyczące praw do źródeł i wyłączenie udzielania porad.

Wymagania cytowania i dowodów

Zachowaj model dowodowy przy ponownym wykorzystaniu danych publicznych.

  • Podawaj kanoniczny adres URL strony oraz publiczny adres URL pliku JSON łącznie.
  • W przypadku ponownego wykorzystania twierdzenia należy zachować źródłowy URL, język, skrót migawki, fragment dowodu, poziom pewności i stan weryfikacji.
  • Pole pewności i pole stanu weryfikacji są oddzielnymi polami.
  • Materiał dowodowy w języku oryginalnym jest rozstrzygający.
  • Nie przedstawiaj twierdzeń wygenerowanych maszynowo ani wymagających przeglądu jako ostatecznych wniosków dotyczących polityki.
  • Punkty końcowe wkładu zawierają wyłącznie metadane. Publiczne zgłoszenia tworzą zadania przeglądu za pomocą szablonów zgłoszeń GitHub, a nie bezpośrednie kanoniczne fakty.

Kontrakt osadzanych widżetów

Publiczne widżety korzystają z tego samego kontraktu API, z włączonym CORS dla JSON osadzanych widżetów i wyszukiwania podmiotów.

Osadzenie JavaScript

Skrypt osadzający renderuje kompaktową kartę w Shadow DOM i odczytuje wyłącznie publiczny JSON specyficzny dla widżetu. Odsyła do kanonicznych stron trackera i unika nieprzejrzanych treści twierdzeń.

Script/widgets/embed.js

Użycie na różnych stronach

Punkty końcowe JSON widżetu i publiczny punkt końcowy wyszukiwania podmiotów zawierają zezwalające nagłówki CORS na potrzeby publicznego osadzania i wyszukiwania w przeglądarce. Inne publiczne punkty końcowe API pozostają standardowym formatem JSON dla tego samego źródła (same-origin), chyba że udokumentowano to oddzielnie.

CORSWidgets and search

Zasady limitów żądań i robotów indeksujących

To publiczne zasady uczciwego korzystania, a nie umowa o poziomie usług płatnego API.

Sugerowany limit
60 requests per minute per client for public JSON usage
Pamięć podręczna klienta
3600 minimum sekund
Masowe użycie
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Użycie crawlerów
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.