Τεκμηρίωση API

Δημόσιο API δεδομένων με εκδόσεις, μόνο για ανάγνωση

Υπηρεσίες αναζήτησης και παραπομπών για μεταδεδομένα δημόσιων πολιτικών. Κάθε σημείο πρόσβασης JSON είναι εκδοσιοποιημένο στο πλαίσιο του /api/public/v1.

Τι επιστρέφει το API

Μεταδεδομένα ιχνηλάτη μόνο για ανάγνωση: κανονικά URL εγγραφών, δημόσιο JSON, καταστάσεις αναθεώρησης, πεδία τεκμηρίωσης, σύνδεσμοι πηγών και πεδία παραπομπών.

Τι δεν κάνει το API

Δεν τροποποιεί εγγραφές, δεν δημοσιεύει εκτελέσεις staging, δεν παρακάμπτει την κατάσταση αναθεώρησης και δεν αντικαθιστά επίσημες πηγές πολιτικής του πανεπιστημίου.

Συνιστώμενη ανάκτηση

Επιλύστε με αναζήτηση ή ψευδώνυμα οντοτήτων, ανακτήστε την πανεπιστημιακή εγγραφή και, στη συνέχεια, επισυνάψτε στοιχεία τεκμηρίωσης ισχυρισμών και URL πηγών για απαντήσεις σε επίπεδο ισχυρισμού.

Τοποθέτηση πρακτόρων και API

Συνιστώμενη χρήση για πράκτορες και εργαλεία δεδομένων.

  • Χρησιμοποιείται για περιλήψεις με βάση πηγές, δημόσιο JSON, μεταδεδομένα αναφορών, κατάσταση εξέτασης και επίσημους συνδέσμους πηγών.
  • Χρησιμοποιείτε τις επίσημες σελίδες του πανεπιστημίου ως πηγή για τη διατύπωση της πολιτικής.
  • Μην θεωρείτε την ανάλυση ως συμβουλή, καθοδήγηση ασφαλείας ή συμμόρφωση.
  • Οι αντιστοιχίσεις ψευδωνύμων, τα θέματα και οι βαθμολογίες κάλυψης δεν δημιουργούν γεγονότα.
  • Οι εγγραφές εργαλείων παράγονται από το κείμενο ισχυρισμών και αποδεικτικών στοιχείων· δεν αντικαθιστούν τη διατύπωση των επίσημων πανεπιστημιακών πηγών.

Προτεινόμενη σειρά ανάκτησης

Ασφαλής σειρά ανάκτησης για πράκτορες που χρειάζονται απαντήσεις με παραπομπές.

Επίλυση της οντότητας

Κλήση /api/public/v1/search.json?q=... ή επιθεώρηση /api/public/v1/entities/index.json για να βρείτε το κανονικό αναγνωριστικό (slug) του πανεπιστημίου. Οι αντιστοιχίσεις ψευδωνύμων βελτιώνουν την ανάκληση, αλλά δεν δημιουργούν γεγονότα.

Step1

Άνοιγμα της κανονικής εγγραφής

Ανάκτηση /api/public/v1/universities/{slug}.json και διατηρήστε τα πεδία κανονικού URL σελίδας, δημόσιου JSON URL, κατάστασης εξέτασης, ημερομηνίας τελευταίου ελέγχου, περιορισμών και παραπομπών μαζί με την απάντηση.

Step2

Επισύναψη τεκμηρίων ισχυρισμού

Ανάκτηση /api/public/v1/claims/{slug}.json όταν απαιτείται επαναχρησιμοποίηση σε επίπεδο ισχυρισμού. Διατηρήστε τα URL των πηγών, τη γλώσσα της πηγής, τα αποσπάσματα τεκμηρίωσης, τα hash στιγμιότυπων (snapshot), το επίπεδο εμπιστοσύνης και την κατάσταση αξιολόγησης.

Step3

Χρήση ανάλυσης ως προκύπτοντα μεταδεδομένα

Ανάκτηση /api/public/v1/analysis/universities/{slug}.json μόνο ως ντετερμινιστικά παραγόμενα μεταδεδομένα. Αναφέρετε πάντοτε τα αναγνωριστικά ισχυρισμών βάσης και τα URL πηγών για μη κενές διαστάσεις ανάλυσης.

Step4

Οικογένειες τελικών σημείων

Εγγραφές, εκδόσεις, γραφικά στοιχεία, ροές και ενσωματώσεις πρακτόρων.

Discovery

Δημόσιο ευρετήριο API με συνδέσμους τελικών σημείων, σελίδες αξιοπιστίας, κανόνες παραπομπών, περιορισμούς και μεταδεδομένα έκδοσης.

Πανεπιστήμια

Κατάλογος δημόσιων εγγραφών πανεπιστημίων με κανονικό URL σελίδας, δημόσιο URL JSON, κατάσταση ελέγχου, ημερομηνίες και πλήθη.

Αναζήτηση οντοτήτων

Αναζήτηση δημόσιων εγγραφών πανεπιστημίων βάσει κανονικού ονόματος, ψευδωνύμου, τίτλου επίσημης πηγής, σύνοψης ισχυρισμού, τομέα πηγής ή διάστασης ανάλυσης.

Ασφαλές ευρετήριο αναζήτησης

Δημόσιο ευρετήριο αναζήτησης έτοιμο για Pagefind, χωρίς ακατέργαστα στιγμιότυπα πηγών, ιδιωτικά αρχεία, αδημοσίευτα τεκμήρια προετοιμασίας και γραμμές υπολογιστικών φύλλων χωρίς ισχύ επίσημης πηγής.

Ευρετήριο ταυτοποίησης οντοτήτων

Ψευδώνυμα κανονικών πανεπιστημιακών οντοτήτων για καλύτερη ανάκτηση. Η αντιστοίχιση ψευδωνύμου δεν δημιουργεί δημόσια δεδομένα πολιτικής.

Πανεπιστημιακή καταγραφή

Μία εγγραφή πανεπιστημίου έτοιμη για παραπομπή, με ισχυρισμούς, αποσπάσματα τεκμηρίων, URL πηγών, βεβαιότητα, κατάσταση ελέγχου και επιφυλάξεις δικαιωμάτων.

Ισχυρισμοί πανεπιστημίων

Γραμμές ισχυρισμών/τεκμηρίων μίας δημόσιας εγγραφής πανεπιστημίου με URL πηγής, γλώσσα πηγής, κατακερματισμό στιγμιοτύπου, βεβαιότητα και κατάσταση ελέγχου.

Κατάλογος εργαλείων τεχνητής νοημοσύνης

Παράγωγες εγγραφές εργαλείων AI πανεπιστημίων με διαθεσιμότητα ανά εργαλείο, τύπο έγκρισης, κατάσταση ελέγχου και αποσπάσματα τεκμηρίων. Είναι μεταδεδομένα ανακάλυψης, όχι επίσημα συμπεράσματα πολιτικής.

Πρόσφατες αλλαγές

Πρόσφατοι έλεγχοι δημόσιων πηγών και τροποποιημένες εγγραφές ιδρυμάτων.

Ευρετήριο API ανάλυσης

Ντετερμινιστικές διαστάσεις ανάλυσης πολιτικής, διαδρομές τελικών σημείων, περιορισμοί και μεταδεδομένα έκδοσης σχήματος.

Προφίλ ανάλυσης πανεπιστημίου

Προφίλ ανάλυσης βάσει πηγών με διαστάσεις, αναγνωριστικά τεκμηριωτικών ισχυρισμών, URL πηγών, βεβαιότητα, κατάσταση ελέγχου και βαθμολογία κάλυψης πολιτικής.

Βαθμολογίες κάλυψης πολιτικής

Κατάλογος βαθμολογιών κάλυψης για δημόσια προφίλ ανάλυσης. Οι βαθμολογίες μετρούν το εύρος της τεκμηριωμένης από πηγές δημόσιας κάλυψης, όχι την ποιότητα της πολιτικής.

Ποιότητα σελίδας ανάλυσης

Πύλες ποιότητας σελίδων μόνο για ανάγνωση, κατάσταση δυνατότητας ευρετηρίασης, ροή ελέγχου αναλύσεων και όρια μη παροχής συμβουλών για δημόσιες σελίδες ανάλυσης.

Κάλυψη QS 2026

Γραμμές κάλυψης συλλογής για στόχους QS 2026 με πεδία δημόσιο, μόνο προετοιμασία, απουσία, πλήθος πηγών, κατάσταση ελέγχου και επόμενη ενέργεια.

Κατάσταση πηγών

Μεταδεδομένα υγείας πηγής/ανάκτησης για δημοσιευμένα δημόσια στιγμιότυπα πηγών και εκτελέσεις προετοιμασίας. Για σχεδιασμό διορθώσεων, όχι δημοσίευση ισχυρισμών.

Ουρά εξέτασης

Μεταδεδομένα αδημοσίευτων εκτελέσεων προετοιμασίας με κατάσταση επικύρωσης, εύρος πηγών, εντοπισμένα αναγνωριστικά διαδρομής και προτεινόμενη επόμενη ενέργεια.

Διάθεση συνόλου δεδομένων

Δηλωτικό έκδοσης με τεχνουργήματα, πλήθη γραμμών, μεγέθη σε byte, αθροίσματα ελέγχου SHA-256, παραπομπή και περιορισμούς.

Ευρετήριο αναφορών

Ευρετήριο αναφορών σε μορφή αναγνώσιμη από μηχανές, με διευθύνσεις URL αναφορών, μετρικές, συνδέσμους δεδομένων, feeds και εντοπισμό για δράσεις επικοινωνίας.

Αναφορά δεδομένων γραφήματος

Κατανομές έτοιμες για γραφήματα της γλώσσας πηγής, κατάστασης ελέγχου, περιφερειακής κάλυψης, κάλυψης πόλης/πανεπιστημιούπολης και κατατάξεων για την τελευταία μηνιαία έκθεση.

Πακέτο διάδοσης εκθέσεων

Μηχαναγνώσιμα κείμενα για μέσα, ενημερωτικά δελτία, email ερευνητών και κοινωνικά δίκτυα με σαφή όρια χρήσης.

Ευρετήριο widget

Δεδομένα ανακάλυψης γραφικών στοιχείων με URL σεναρίου, υποστηριζόμενα στοιχεία, περιορισμούς και παράδειγμα HTML.

Γραφικό στοιχείο κατάστασης πανεπιστημίου

Συνοπτικά δεδομένα στοιχείου με επικαιρότητα, κατάσταση ελέγχου, πλήθη ισχυρισμών/πηγών και κανονικούς συνδέσμους.

Γραφικό στοιχείο πρόσφατων αλλαγών

Συνοπτικά δεδομένα πρόσφατων αλλαγών για στοιχεία ελέγχου δημόσιων πηγών και αλλαγών.

Widget κάλυψης πολιτικής

Συνοπτικά δεδομένα στοιχείου κάλυψης πολιτικής βάσει πηγών. Η κάλυψη δηλώνει εύρος, όχι ποιότητα πολιτικής.

Γραφικό στοιχείο επικαιρότητας πηγής

Συνοπτικά δεδομένα στοιχείου επικαιρότητας πηγών με ημερομηνία τελευταίου ελέγχου, πλήθος πηγών και μετρήσεις υγείας δημόσιων πηγών.

Γραφικό στοιχείο (widget) κατάστασης επανεξέτασης

Συνοπτικά δεδομένα στοιχείου κατάστασης ελέγχου με βεβαιότητα, ελεγμένους ισχυρισμούς και πλήθος υποψήφιων ισχυρισμών.

Δηλωτικό MCP άλφα

Δηλωτικό σχεδιασμού MCP μόνο για ανάγνωση με επιτρεπόμενες μορφές εργαλείων, απαγορευμένες ενέργειες και παραδείγματα ερωτημάτων πρακτόρων.

Κατάλογος εργαλείων MCP

Κατάλογος εργαλείων MCP άλφα μόνο για ανάγνωση με σχήματα εισόδου, υποχρεωτικά πεδία εξόδου και αυστηρά απαγορευμένες μεταβολές.

Πολιτική ορίων ρυθμού

Μηχαναγνώσιμη δημόσια πολιτική εύλογης χρήσης για πρόσβαση API, γραφικών στοιχείων και ανιχνευτών.

Μεταδεδομένα αναφοράς

Μηχαναγνώσιμα πρότυπα παραπομπών, υποχρεωτικά πεδία, κανόνες τεκμηρίων, επιφύλαξη δικαιωμάτων πηγής και όριο μη παροχής συμβουλών.

Δείκτης συνεισφοράς

Μεταδεδομένα ροής συνεισφορών μόνο για ανάγνωση, URL προτύπων ζητημάτων GitHub, δικλίδες ασφαλείας και κανόνες δημοσίευσης.

Πολιτική ελέγχου συνεισφορών

Ορισμοί ουρών ελέγχου, όρια εποπτείας και πύλες δημοσίευσης μόνο για ανάγνωση.

Απαιτήσεις παραπομπών και τεκμηρίων

Διατηρήστε το μοντέλο τεκμηρίων κατά την επαναχρησιμοποίηση δημόσιων δεδομένων.

  • Παραθέστε μαζί το κανονικό URL της σελίδας και το δημόσιο URL του JSON.
  • Διατηρήστε το URL πηγής, τη γλώσσα, τον κατακερματισμό στιγμιότυπου (snapshot hash), το απόσπασμα τεκμηρίωσης, τον βαθμό βεβαιότητας και την κατάσταση επανεξέτασης κατά την επαναχρησιμοποίηση ισχυρισμών.
  • Το επίπεδο εμπιστοσύνης και η κατάσταση ελέγχου είναι ξεχωριστά πεδία.
  • Τα αποδεικτικά στοιχεία στην αρχική γλώσσα είναι τα κανονιστικά.
  • Μην παρουσιάζετε ισχυρισμούς υποψήφιους από μηχανή ή ισχυρισμούς που χρειάζονται έλεγχο ως τελικά συμπεράσματα πολιτικής.
  • Τα σημεία υποβολής συνεισφορών περιέχουν μόνο μεταδεδομένα. Οι δημόσιες υποβολές δημιουργούν εργασίες αναθεώρησης μέσω προτύπων ζητημάτων του GitHub, και όχι άμεσα καθιερωμένα στοιχεία.

Σύμβαση ενσωματώσιμων γραφικών στοιχείων

Τα δημόσια γραφικά στοιχεία χρησιμοποιούν την ίδια σύμβαση API, με ενεργό CORS για ενσωματώσιμο JSON στοιχείων και αναζήτηση οντοτήτων.

Ενσωμάτωση JavaScript

Το σενάριο ενσωμάτωσης αποδίδει μια συμπαγή κάρτα Shadow DOM και διαβάζει μόνο δημόσιο JSON ειδικό για το widget. Παραπέμπει πίσω στις κανονικές σελίδες του tracker και αποφεύγει κείμενο ισχυρισμών που δεν έχει ελεγχθεί.

Script/widgets/embed.js

Χρήση σε διαφορετικούς ιστότοπους

Τα JSON τελικά σημεία του widget και το δημόσιο τελικό σημείο αναζήτησης οντοτήτων περιλαμβάνουν επιτρεπτικές κεφαλίδες CORS για δημόσια ενσωμάτωση και αναζήτηση μέσω προγράμματος περιήγησης. Άλλα δημόσια τελικά σημεία API παραμένουν κανονικά JSON ίδιας προέλευσης, εκτός εάν τεκμηριώνεται διαφορετικά.

CORSWidgets and search

Πολιτική ορίων ρυθμού και ανιχνευτών

Πρόκειται για δημόσια πολιτική εύλογης χρήσης, όχι για SLA επί πληρωμή API.

Προτεινόμενο όριο
60 requests per minute per client for public JSON usage
Cache πελάτη
3600 ελάχιστος χρόνος (δευτερόλεπτα)
Μαζική χρήση
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Χρήση crawlers
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.