Những gì API trả về
Siêu dữ liệu trình theo dõi chỉ đọc: URL hồ sơ chuẩn, JSON công khai, trạng thái đánh giá, trường bằng chứng, liên kết nguồn và trường trích dẫn.
Tài liệu tham khảo API
API dữ liệu công khai, chỉ đọc, có phiên bản
Các điểm cuối tra cứu và trích dẫn cho siêu dữ liệu chính sách công khai. Mọi điểm cuối JSON đều được đánh phiên bản theo /api/public/v1.
API không thể làm những gì
Nó không thay đổi hồ sơ, không đăng các lần chạy thử (staging), không bỏ qua trạng thái rà soát, và không thay thế các nguồn chính sách chính thức của trường đại học.
Truy xuất được khuyến nghị
Giải quyết bằng tìm kiếm hoặc tên thay thế của thực thể, lấy hồ sơ trường đại học, sau đó đính kèm bằng chứng tuyên bố và URL nguồn cho các câu trả lời ở cấp tuyên bố.
Định vị tác nhân và API
Cách dùng đề xuất cho tác nhân và công cụ dữ liệu.
- Dùng cho tóm tắt có nguồn, JSON công khai, siêu dữ liệu trích dẫn, trạng thái rà soát và liên kết nguồn chính thức.
- Sử dụng các trang chính thức của trường làm cơ sở thẩm quyền cho ngôn ngữ chính sách.
- Không coi phân tích này là lời khuyên, hướng dẫn an toàn hay sự tuân thủ.
- Các trùng khớp bí danh, chủ đề và điểm bao phủ không tạo ra dữ kiện.
- Các hồ sơ công cụ được rút ra từ văn bản tuyên bố và bằng chứng; chúng không thay thế ngôn ngữ nguồn chính thức của trường đại học.
Trình tự truy xuất được khuyến nghị
Thứ tự truy xuất an toàn cho tác nhân cần câu trả lời có trích dẫn.
Xác định thực thể
Gọi /api/public/v1/search.json?q=... hoặc kiểm tra /api/public/v1/entities/index.json để tìm slug chuẩn của trường đại học. Khớp theo bí danh giúp tăng độ bao phủ tìm kiếm, nhưng không tạo ra dữ kiện mới.
Mở bản ghi chính thức
Lấy dữ liệu /api/public/v1/universities/{slug}.json và giữ các trường URL trang chuẩn, URL JSON công khai, trạng thái xem xét, ngày kiểm tra gần nhất, các giới hạn và trích dẫn cùng với câu trả lời.
Đính kèm bằng chứng tuyên bố
Lấy dữ liệu /api/public/v1/claims/{slug}.json khi cần tái sử dụng ở cấp độ khẳng định. Giữ nguyên URL nguồn, ngôn ngữ nguồn, đoạn trích bằng chứng, mã băm ảnh chụp, độ tin cậy và trạng thái rà soát.
Sử dụng phân tích làm siêu dữ liệu suy ra
Lấy dữ liệu /api/public/v1/analysis/universities/{slug}.json chỉ dưới dạng siêu dữ liệu suy ra mang tính tất định. Luôn trích dẫn các Claim ID căn cứ và URL nguồn cho các chiều phân tích không rỗng.
Nhóm điểm cuối
Hồ sơ, bản phát hành, tiện ích, nguồn tin và tích hợp tác nhân.
Discovery
Mục lục API công khai gồm liên kết điểm cuối, trang về độ tin cậy, quy tắc trích dẫn, hạn chế và siêu dữ liệu phiên bản.
Các trường đại học
Danh sách hồ sơ đại học công khai gồm URL trang chuẩn, URL JSON công khai, trạng thái xét duyệt, ngày và số lượng.
Tìm kiếm thực thể
Tìm hồ sơ đại học công khai theo tên chuẩn, tên khác, tiêu đề nguồn chính thức, tóm tắt nhận định, tên miền nguồn hoặc chiều phân tích.
Chỉ mục tìm kiếm an toàn
Chỉ mục tìm kiếm công khai dùng được với Pagefind, loại trừ bản chụp nguồn thô, tệp riêng tư, bằng chứng tạm chưa công bố và hàng bảng tính không có thẩm quyền.
Chỉ mục phân giải thực thể
Tên khác của thực thể đại học chuẩn để tăng khả năng tìm thấy. Khớp tên khác không tạo ra sự kiện chính sách công khai.
Hồ sơ trường đại học
Một hồ sơ đại học sẵn sàng trích dẫn, gồm nhận định, trích đoạn bằng chứng, URL nguồn, độ tin cậy, trạng thái xét duyệt và lưu ý về quyền.
Nhận định về đại học
Các hàng nhận định/bằng chứng của một hồ sơ đại học công khai, gồm URL nguồn, ngôn ngữ nguồn, hàm băm bản chụp, độ tin cậy và trạng thái xét duyệt.
Danh mục công cụ AI
Hồ sơ công cụ AI đại học được suy ra, gồm khả năng sử dụng từng công cụ, loại bảo chứng, trạng thái xét duyệt và trích đoạn bằng chứng. Đây là siêu dữ liệu để tìm kiếm, không phải kết luận chính sách chính thức.
Thay đổi gần đây
Các lần kiểm tra nguồn công khai gần đây và hồ sơ cơ sở đã thay đổi.
Chỉ mục API phân tích
Các chiều phân tích chính sách xác định, đường dẫn điểm cuối, hạn chế và siêu dữ liệu phiên bản lược đồ.
Hồ sơ phân tích trường đại học
Hồ sơ phân tích dựa trên nguồn gồm các chiều, ID nhận định bằng chứng, URL nguồn, độ tin cậy, trạng thái xét duyệt và điểm bao phủ chính sách.
Điểm bao phủ chính sách
Danh sách điểm phạm vi bao phủ cho các hồ sơ phân tích công khai. Điểm số đo lường mức độ rộng của phạm vi bao phủ công khai được hỗ trợ bởi nguồn, không phải chất lượng chính sách.
Chất lượng trang phân tích
Các cổng kiểm soát chất lượng trang chỉ đọc, trạng thái khả năng lập chỉ mục, quy trình rà soát phân tích và ranh giới không đưa ra tư vấn đối với các trang phân tích công khai.
Phạm vi QS 2026
Các hàng bao phủ thu thập cho mục tiêu QS 2026, gồm trường công khai, chỉ ở vùng tạm, còn thiếu, số nguồn, trạng thái xét duyệt và hành động tiếp theo.
Tình trạng nguồn
Siêu dữ liệu tình trạng nguồn/truy xuất cho bản chụp nguồn đã công bố và lượt chạy vùng tạm. Dùng để lập kế hoạch sửa chữa, không để công bố nhận định.
Hàng đợi xem xét
Siêu dữ liệu lượt chạy vùng tạm chưa công bố, gồm trạng thái xác thực, độ rộng nguồn, định danh đường dẫn phát hiện được và hành động tiếp theo được đề xuất.
Phát hành tập dữ liệu
Bản kê phát hành gồm sản phẩm, số hàng, kích thước byte, mã kiểm tra SHA-256, trích dẫn và hạn chế.
Chỉ mục báo cáo
Chỉ mục báo cáo dạng máy đọc được, gồm đường dẫn báo cáo, chỉ số, liên kết dữ liệu, nguồn cấp dữ liệu và khám phá để tiếp cận.
Xuất dữ liệu biểu đồ
Phân bố ngôn ngữ nguồn, trạng thái xét duyệt, bao phủ khu vực, thành phố/cơ sở và thứ hạng, sẵn sàng vẽ biểu đồ cho báo cáo tháng mới nhất.
Gói phổ biến báo cáo
Nội dung truyền thông, bản tin, email nhà nghiên cứu và mạng xã hội ở dạng máy đọc được, với giới hạn sử dụng rõ ràng.
Chỉ mục tiện ích (widget)
Dữ liệu khám phá tiện ích gồm URL tập lệnh, tiện ích hỗ trợ, ràng buộc và HTML ví dụ.
Tiện ích trạng thái đại học
Dữ liệu tiện ích gọn gồm độ cập nhật, trạng thái xét duyệt, số nhận định/nguồn và liên kết chuẩn.
Tiện ích thay đổi gần đây
Dữ liệu thay đổi gần đây gọn cho tiện ích kiểm tra nguồn công khai và thay đổi.
Tiện ích phạm vi bao quát chính sách
Dữ liệu tiện ích bao phủ chính sách gọn, dựa trên nguồn. Bao phủ đo độ rộng, không đo chất lượng chính sách.
Tiện ích độ mới của nguồn
Dữ liệu tiện ích độ cập nhật nguồn gọn, gồm ngày kiểm tra gần nhất, số nguồn và số liệu tình trạng nguồn công khai.
Widget trạng thái xem xét
Dữ liệu tiện ích trạng thái xét duyệt gọn, gồm độ tin cậy, nhận định đã xét duyệt và số nhận định ứng viên.
Bản kê MCP alpha
Bản kê thiết kế MCP chỉ đọc, gồm dạng công cụ được phép, hành động bị cấm và truy vấn mẫu của tác nhân.
Danh mục công cụ MCP
Danh mục công cụ MCP alpha chỉ đọc, gồm lược đồ đầu vào, trường đầu ra bắt buộc và thay đổi bị nghiêm cấm.
Chính sách giới hạn tần suất
Chính sách sử dụng hợp lý công khai, máy đọc được cho truy cập API, tiện ích và trình thu thập dữ liệu.
Siêu dữ liệu trích dẫn
Mẫu trích dẫn, trường bắt buộc, quy tắc bằng chứng, lưu ý quyền nguồn và giới hạn không tư vấn, ở dạng máy đọc được.
Chỉ số đóng góp
Siêu dữ liệu quy trình đóng góp chỉ đọc, URL mẫu vấn đề GitHub, biện pháp bảo vệ và quy tắc công bố.
Chính sách xét duyệt đóng góp
Định nghĩa hàng đợi xét duyệt, giới hạn kiểm duyệt và cổng công bố chỉ đọc.
Yêu cầu về trích dẫn và bằng chứng
Giữ nguyên mô hình bằng chứng khi tái sử dụng dữ liệu công khai.
- Trích dẫn URL trang chuẩn cùng với URL JSON công khai.
- Giữ nguyên URL nguồn, ngôn ngữ, mã băm bản ghi tức thời, đoạn trích bằng chứng, độ tin cậy và trạng thái rà soát khi tái sử dụng tuyên bố.
- Mức độ tin cậy và trạng thái rà soát là các trường riêng biệt.
- Bằng chứng bằng ngôn ngữ gốc có giá trị chuẩn mực.
- Không trình bày các nhận định do máy đề xuất hoặc cần rà soát như kết luận chính sách cuối cùng.
- Các điểm tiếp nhận đóng góp chỉ là siêu dữ liệu. Các bài gửi công khai tạo ra nhiệm vụ rà soát thông qua mẫu issue trên GitHub, chứ không phải là dữ kiện chuẩn trực tiếp.
Hợp đồng tiện ích nhúng
Tiện ích công khai dùng cùng hợp đồng API, bật CORS cho JSON tiện ích nhúng và tìm kiếm thực thể.
Mã nhúng JavaScript
Đoạn mã nhúng hiển thị một thẻ gọn dùng Shadow DOM và chỉ đọc dữ liệu JSON công khai dành riêng cho widget. Thẻ này liên kết ngược về các trang chuẩn của trình theo dõi và tránh hiển thị nội dung khẳng định chưa được thẩm định.
Sử dụng trên nhiều trang web
Các điểm cuối JSON của tiện ích và điểm cuối tìm kiếm thực thể công khai bao gồm các tiêu đề CORS cho phép đối với việc nhúng công khai và tra cứu dựa trên trình duyệt. Các điểm cuối API công khai khác vẫn là JSON cùng nguồn gốc thông thường trừ khi được ghi nhận riêng.
Chính sách giới hạn tần suất và trình thu thập dữ liệu
Đây là chính sách sử dụng hợp lý công khai, không phải SLA API trả phí.
This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.