CLOSE ✕
Get in Touch
Thank you for your interest! Please fill out the form below if you would like to work together.

Thank you! Your submission has been received!

Oops! Something went wrong while submitting the form

National Library of Israel for Developers

ברוכים הבאים

הספרייה הלאומית של ישראל פותחת את מאגרי המידע שלה לשימוש ישיר!

באמצעות שימוש ב-API בתקנים מקובלים בעולם, תוכלו לחפש ולשלוף מידע - כולל שליפה פשוטה וקלה של העתקים דיגיטליים (תמונות, וידאו ושמע) בהזרמה ישירות למשתמש הקצה.

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

הגעתם למקום הנכון.

הספרייה הלאומית כאן בשבילכם - כלל החומר נגיש בחינם, עכשיו.

(שימו לב כי במקרים מסוימים השימוש בפריטים עלול להיות כפוף לתנאי זכויות יוצרים)

אודות תקן IIIF

תקן International Image Interoperability Framework, או פשוט IIIF (מבוטא "טריפל איי אף") נולד בשנת 2012 במטרה לתקנן ולהסדיר גישה למשאבים מבוססי תמונה - תצלומים, כתבי יד, מפות, ספרים ועוד. התקן מאומץ ע"י מספר הולך וגובר של ספקי תוכן בתחום המורשת וההיסטוריה (כמו ספריות לאומיות, מכון Getty ועוד). מצד שני, מספר גובר והולך של מוצרים (כולל בקהילת ה-Open Source) מפתחים יכולות צפייה בתוכן באמצעות תקן זה.

התקן מגדיר שני ממשקי API עיקריים: הראשון הוא Presentation והשני Image, ונספר עליהם בקצרה כולל דוגמאות שימוש מעשיות. כל המידע המלא על השימוש בתקן נמצא באתר המצויין שלו, iiif.io ואתם מוזמנים לעשות בו שימוש.

הסבר על התהליך

תהליך השימוש במידע מחייב ראשית איתור של הפרטי/ים שבו אתם מעוניינים לצפות, ע"י ביצוע חיפוש, וממשיך בשליפה של הפריט באמצעות ה-API.

איתור פריטים

איתור הפריטים מתבצע באמצעות ה-Search API שלנו.

אנו מפרסמים קבצים עם רשימת הפריטים (בעמוד ה-Search API), הכוללת את כותרת הפריט והמזהה שלו, בפורמט JSON.
כל קובץ מרכז פריטים הקשורים לאוסף מסוים.
האוספים הללו הם IIIF Collection (ראו הסבר כאן).

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

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

שליפת פריטים

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

שליפת הפריט מתבצעת ע"י פנייה ל-Presentation API (בתקן IIIF) עם מזהה הפריט. המערכת תחזיר לכם JSON שמהווה את ה-Manifest של הפריט (עפ"י תקן IIIF). 

ה-Manifest יכלול מידע כמו:

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

הקישורים הם בעצם הפנייה לשכבת API של שליפה: