API ציבורי
API ציבורי לקריאה בלבד עבור רשומות, אוספים, ישויות, תערוכות וייצואים שפורסמו. הארגון נקבע לפי מארח הבקשה ואין צורך במפתח API.
זיהוי הארגון
הכותרת Host או X-Forwarded-Host מזהה ארגון פעיל אחד. כל תשובת מידע מוגבלת לאותו ארגון; מארח שאינו ממופה מקבל 404, למעט נקודות הקצה של הבריאות והתיעוד.
מגבלת קצב
200 בקשות בדקה לכל כתובת IP
נקודות קצה
- GET
/api/public/recordsרשימה מדופדפת של רשומות שפורסמו.
פרמטרים של השאילתה
- page
- מספר שלם, ברירת מחדל 1
- limit
- מספר שלם, עד 100
- collection
- מזהה אוסף; כולל צאצאים
- language
- קוד שפה לפי ISO
- GET
/api/public/records/:slugפרטי רשומה שפורסמה, כולל ישויות גלויות, אבות, אחים וקישורי הקודם והבא.
- GET
/api/public/collectionsחטיבות ואוספים ראשיים שפורסמו, כולל תמונות שער וסיכומי תאריכים.
- GET
/api/public/collections/:slugפרטי אוסף שפורסם, כולל ילדים גלויים, מספר צאצאים ונתיב ניווט.
- GET
/api/public/collections/:slug/ead.xmlייצוא עזר איתור ב־EAD3 עבור אוסף שפורסם ועומד בתנאים.
- GET
/api/public/collections/:slug/finding-aid.pdfעזר איתור ב־PDF עבור אוסף שפורסם ועומד בתנאים.
- GET
/api/public/entitiesרשומות סמכות המקושרות לרשומות שפורסמו.
פרמטרים של השאילתה
- page
- מספר שלם
- limit
- מספר שלם
- entity_type
- person|corporate_body|place|subject|family
- search
- טקסט
- letter
- תו אחד
- GET
/api/public/entities/:slugOrIdפרטי רשומת סמכות גלויה, כולל הערות ציבוריות ורשומות שפורסמו.
- GET
/api/public/entities/:slugOrId/recordsרשומות שפורסמו ומקושרות לרשומת סמכות גלויה, לפי רמת ביטחון.
פרמטרים של השאילתה
- limit
- מספר שלם
- exclude
- UUID של רשומה להשמטה
- GET
/api/public/entities/:slug/eac.xmlייצוא EAC-CPF עבור רשומת סמכות שעומדת בתנאים.
- GET
/api/public/searchחיפוש ברשומות ציבוריות שפורסמו, עם תחיליות השדה person:, place: ו־subject:.
פרמטרים של השאילתה
- q
- טקסט לחיפוש
- collection
- מזהה אוסף; כולל צאצאים
- person
- שם ישות
- place
- שם מקום
- subject
- שם נושא
- date_start
- שנת התחלה
- date_end
- שנת סיום
- language
- קוד שפה לפי ISO
- sort
- relevance|date|date_desc|title|quality
- page
- מספר שלם
- limit
- מספר שלם
- GET
/api/public/cite/:slugמחרוזות ציטוט Chicago 17, APA 7 ו־MLA 9 עבור רשומה שפורסמה.
- GET
/api/public/images/:orgId/:recordId/thumbתמונה ממוזערת ציבורית ב־JPEG, עד 400 פיקסלים בצלע, כאשר הרשאות המדיה מאפשרות זאת.
- GET
/api/public/images/:orgId/:recordId/originalהקובץ המקורי שהועלה, רק כאשר החלטת הגישה האפקטיבית למדיה מאפשרת זאת.
- GET
/api/public/iiif/:orgId/:recordId/manifest.jsonמניפסט IIIF Presentation API 3.0 עבור תמונה שפורסמה ועומדת בתנאים. אין בכך טענה ל־IIIF Image API.
- GET
/api/public/oaiנקודת קצה לפי OAI-PMH 2.0 עם שש פעולות הפרוטוקול והפורמטים oai_dc, oai_qdc ו־oai_ead.
- GET
/api/public/exhibitsתערוכות אוצרות שפורסמו.
- GET
/api/public/healthבדיקת תקינות ציבורית של השירות.
- GET
/api/public/docsתיעוד ה־API הנוכחי בפורמט קריא למכונה.
פרמטרים של השאילתה
- lang
- en|he
JSON גולמי
הגרסה הניתנת לקריאה על ידי מכונה זמינה בכתובת:
/api/public/docs