University AI Policy Tracker
APIGitHub
עברית

תיעוד ה-API

ממשק API ציבורי לנתונים לקריאה בלבד, עם ניהול גרסאות

נקודות קצה לציטוט ולחיפוש של מטא-נתונים של מדיניות ציבורית. כל נקודת קצה ב-JSON מנוהלת בגרסאות תחת /api/public/v1.

מה שה-API מחזיר

מטא-נתונים של מערכת המעקב לקריאה בלבד: כתובות URL קנוניות של רשומות, JSON ציבורי, מצבי בדיקה, שדות ראיות, קישורי מקור ושדות ציטוט.

מה ה-API אינו עושה

הוא אינו משנה רשומות, אינו מפרסם הרצות שלב הכנה, אינו עוקף את מצב הסקירה ואינו מחליף את מקורות המדיניות הרשמיים של האוניברסיטה.

שליפה מומלצת

פתרו באמצעות חיפוש או כינויי ישויות, אחזרו את רישום האוניברסיטה, ולאחר מכן צרפו ראיות טענה וכתובות URL של מקורות עבור תשובות ברמת הטענה.

מיצוב סוכנים ו־API

שימוש מומלץ לסוכנים ולכלי נתונים.

  • לשימוש בסיכומים מבוססי מקורות, JSON ציבורי, מטא-נתוני ציטוט, מצב סקירה וקישורים רשמיים למקורות.
  • יש להשתמש בדפים הרשמיים של האוניברסיטה כסמכות לניסוח המדיניות.
  • אין להתייחס לניתוח כעצה, כהנחיית בטיחות או כציות.
  • התאמות כינויים, נושאים וציוני כיסוי אינם יוצרים עובדות.
  • רשומות כלים נגזרות מטקסט הטענה והראיות; הן אינן מחליפות את לשון המקור הרשמית של האוניברסיטה.

סדר אחזור מומלץ

סדר אחזור בטוח לסוכנים הזקוקים לתשובות מגובות בציטוטים.

פתרון הישות

שיחה /api/public/v1/search.json?q=... או לבדוק /api/public/v1/entities/index.json כדי לאתר את המזהה הקנוני (slug) של האוניברסיטה. התאמות כינויים משפרות את האחזור, אך אינן יוצרות עובדות.

Step1

פתחו את הרשומה הקנונית

אחזר /api/public/v1/universities/{slug}.json ושמור על שדות ה-canonical page URL, ה-public JSON URL, מצב הבדיקה, תאריך הבדיקה האחרון, המגבלות והציטוטים יחד עם התשובה.

Step2

צרף ראיות לטענה

אחזר /api/public/v1/claims/{slug}.json כאשר נדרש שימוש חוזר ברמת הטענה. שמרו על כתובות URL של המקורות, שפת המקור, קטעי ראיה, ערכי גיבוב (hash) של תמונות מצב, רמת ביטחון ומצב הבדיקה.

Step3

השתמשו בניתוח כמטא-נתונים נגזרים

אחזר /api/public/v1/analysis/universities/{slug}.json רק כמטא-נתונים נגזרים דטרמיניסטיים. צטטו תמיד את מזהי טענת הבסיס וכתובות ה-URL של המקור עבור ממדי ניתוח שאינם ריקים.

Step4

משפחות נקודות קצה

רשומות, מהדורות, רכיבים, הזנות ושילובי סוכנים.

Discovery

אינדקס API ציבורי עם קישורי נקודות קצה, דפי אמינות, כללי ציטוט, מגבלות ומטא־נתוני גרסה.

GET/api/public/v1/index.jsonRead-only

אוניברסיטאות

רשימת רשומות אוניברסיטאות ציבוריות עם URL של הדף הקנוני, URL של JSON ציבורי, מצב בדיקה, תאריכים וכמויות.

GET/api/public/v1/universities.jsonRead-only

חיפוש ישויות

חיפוש רשומות אוניברסיטאות ציבוריות לפי שם קנוני, כינוי, כותרת מקור רשמי, תקציר טענה, מתחם מקור או ממד ניתוח.

GET/api/public/v1/search.json?q={query}Read-only

אינדקס חיפוש בטוח

אינדקס חיפוש ציבורי מותאם ל־Pagefind, ללא צילומי מקור גולמיים, קבצים פרטיים, ראיות בסביבת הכנה שטרם פורסמו ושורות גיליון שאינן סמכותיות.

GET/api/public/v1/search/index.jsonRead-only

אינדקס זיהוי ישויות

כינויים לישויות אוניברסיטאיות קנוניות לשיפור האחזור. התאמת כינוי אינה יוצרת עובדות מדיניות ציבוריות.

GET/api/public/v1/entities/index.jsonRead-only

רשומת אוניברסיטה

רשומת אוניברסיטה מוכנה לציטוט, עם טענות, קטעי ראיות, כתובות URL של מקורות, רמת ביטחון, מצב בדיקה והסתייגויות זכויות.

GET/api/public/v1/universities/{slug}.jsonRead-only

טענות על אוניברסיטאות

שורות טענות/ראיות של רשומת אוניברסיטה ציבורית אחת, עם URL מקור, שפת מקור, גיבוב צילום מצב, רמת ביטחון ומצב בדיקה.

GET/api/public/v1/claims/{slug}.jsonRead-only

מדריך כלי AI

רשומות נגזרות של כלי AI באוניברסיטאות, עם זמינות לכל כלי, סוג תמיכה, מצב בדיקה וקטעי ראיות. אלו מטא־נתונים לגילוי, ולא מסקנות מדיניות רשמיות.

GET/api/public/v1/tools.jsonRead-only

אינדקס ה-API של ניתוח

ממדי ניתוח מדיניות דטרמיניסטיים, נתיבי נקודות קצה, מגבלות ומטא־נתוני גרסת סכמה.

GET/api/public/v1/analysis/index.jsonRead-only

פרופיל ניתוח אוניברסיטאי

פרופיל ניתוח מבוסס מקורות עם ממדים, מזהי טענות ראיה, כתובות URL של מקורות, רמת ביטחון, מצב בדיקה וציון כיסוי מדיניות.

GET/api/public/v1/analysis/universities/{slug}.jsonRead-only

ציוני כיסוי מדיניות

רשימת ציוני כיסוי לפרופילי ניתוח ציבוריים. הציונים מודדים את רוחב הכיסוי הציבורי המגובה במקורות, ולא את איכות המדיניות.

GET/api/public/v1/analysis/coverage-scores.jsonRead-only

איכות דף הניתוח

שערי איכות לקריאה בלבד של עמודים, מצב יכולת אינדוקס, זרימת עבודה לבדיקת ניתוחים וגבולות 'ללא ייעוץ' לעמודי ניתוח ציבוריים.

GET/api/public/v1/analysis/page-quality.jsonRead-only

כיסוי QS 2026

שורות כיסוי איסוף ליעדי QS 2026 עם שדות ציבורי, הכנה בלבד, חסר, מספר מקורות, מצב בדיקה ופעולה הבאה.

GET/api/public/v1/coverage/qs-2026.jsonRead-only

תקינות המקורות

מטא־נתוני תקינות מקור/שליפה לצילומי מקורות ציבוריים שפורסמו ולהרצות הכנה. משמשים לתכנון תיקון, לא לפרסום טענות.

GET/api/public/v1/source-health.jsonRead-only

תור סקירה

מטא־נתונים של הרצות הכנה שטרם פורסמו, עם מצב אימות, רוחב מקורות, מזהי נתיב שזוהו והפעולה הבאה המומלצת.

GET/api/public/v1/review/queue.jsonRead-only

שחרור מערך נתונים

מניפסט מהדורה עם תוצרים, מספרי שורות, גדלים בבתים, סכומי ביקורת SHA-256, ציטוט ומגבלות.

GET/api/public/v1/datasets/latest.jsonRead-only

אינדקס דוחות

אינדקס דוחות הניתנים לקריאה על ידי מכונה, הכולל כתובות דוחות, מדדים, קישורי נתונים, הזנות ואיתור לצורכי הפצה.

GET/api/public/v1/reports/index.jsonRead-only

דיווח נתוני התרשים

התפלגויות מוכנות לתרשים של שפת מקור, מצב בדיקה, כיסוי אזורי, כיסוי עיר/קמפוס וכיסוי דירוגים לדוח החודשי האחרון.

GET/api/public/v1/reports/monthly/2026-09/chart-data.jsonRead-only

חבילת הפצת דוחות

תוכן קריא למכונה לתקשורת, לניוזלטר, לדוא״ל לחוקרים ולרשתות חברתיות, עם גבולות שימוש מפורשים.

GET/api/public/v1/reports/outreach.jsonRead-only

אינדקס וידג'טים

נתוני גילוי רכיבים עם URL של סקריפט, רכיבים נתמכים, אילוצים ו־HTML לדוגמה.

GET/api/public/v1/widgets/index.jsonRead-only

וידג'ט עדכניות מקור

נתוני רכיב עדכניות מקורות תמציתיים עם תאריך הבדיקה האחרון, מספר מקורות וספירות תקינות מקורות ציבוריים.

GET/api/public/v1/widgets/source-freshness/{slug}.jsonRead-only

מניפסט MCP אלפא

מניפסט תכנון MCP לקריאה בלבד עם מבני כלים מותרים, פעולות אסורות ושאילתות סוכן לדוגמה.

GET/api/public/v1/mcp/manifest.jsonRead-only

קטלוג כלי MCP

קטלוג כלי MCP אלפא לקריאה בלבד עם סכמות קלט, שדות פלט נדרשים ושינויים אסורים בהחלט.

GET/api/public/v1/mcp/tool-catalog.jsonRead-only

מדיניות הגבלת קצב

מדיניות ציבורית קריאה למכונה לשימוש הוגן בגישת API, רכיבים וסורקים.

GET/api/public/v1/rate-limit-policy.jsonRead-only

מטא-נתונים של ציטוט

תבניות ציטוט קריאות למכונה, שדות נדרשים, כללי ראיות, הסתייגות זכויות מקור וגבול אי־מתן ייעוץ.

GET/api/public/v1/citation.jsonRead-only

מדד תרומה

מטא־נתוני תהליך תרומה לקריאה בלבד, כתובות URL של תבניות סוגיות GitHub, אמצעי הגנה וכללי פרסום.

GET/api/public/v1/contributions/index.jsonRead-only

דרישות ציטוט וראיות

יש לשמר את מודל הראיות בשימוש חוזר בנתונים ציבוריים.

  • צטט את כתובת ה-URL הקנונית של הדף ואת כתובת ה-URL הציבורית של ה-JSON יחד.
  • יש לשמור את כתובת ה-URL של המקור, השפה, גיבוב תמונת המצב, קטע הראיות, רמת המהימנות ומצב הבדיקה יחד עם שימוש חוזר בטענה.
  • רמת הביטחון ומצב הבדיקה הם שדות נפרדים.
  • ראיות בשפת המקור הן הקובעות.
  • אין להציג טענות מועמדות שנוצרו בידי מכונה, או טענות הטעונות בדיקה, כמסקנות מדיניות סופיות.
  • נקודות הקצה לתרומות הן מטא-דאטה בלבד. הגשות ציבוריות יוצרות משימות סקירה באמצעות תבניות Issue של GitHub, ולא עובדות קנוניות ישירות.

חוזה רכיב להטמעה

רכיבים ציבוריים משתמשים באותו חוזה API, עם CORS מופעל ל־JSON של רכיבים מוטמעים ולחיפוש ישויות.

הטמעת JavaScript

סקריפט ההטמעה מציג כרטיס קומפקטי ב-Shadow DOM וקורא רק JSON ציבורי ספציפי לווידג'ט. הוא מקשר חזרה לדפי המעקב הקנוניים ונמנע מטקסט של טענות שלא נבדקו.

Script/widgets/embed.js

שימוש חוצה אתרים

נקודות הקצה של JSON לווידג'טים ונקודת החיפוש הציבורית של ישויות כוללות כותרות CORS מתירניות להטמעה ציבורית ולחיפוש בדפדפן. נקודות API ציבוריות אחרות נשארות JSON רגיל מאותו מקור, אלא אם תועדו בנפרד.

CORSWidgets and search

מדיניות הגבלת קצב וסורקים

זוהי מדיניות ציבורית לשימוש הוגן, לא SLA של API בתשלום.

מגבלה מוצעת
60 requests per minute per client for public JSON usage
מטמון צד לקוח
3600 מינימום שניות
שימוש בכמויות גדולות
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
שימוש ב-Crawler
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.