התחלה מהירה
בקשת GET אחת לכתובת הבאה. זה הכול:
GET /?q=שיעור פרשת השבוע&n=10
אפשר לנסות ישר מכאן (מוגבל לקריאה אחת לשנייה):
פרמטרים
| שם | חובה | תיאור |
|---|---|---|
q | כן | מילות החיפוש. כל המילים חייבות להופיע בשם הסרטון או בשם הערוץ, ואפשר לכתוב רק תחילת מילה. סימני פיסוק מתעלמים. עד 100 תווים. |
n | לא | כמה תוצאות להחזיר. ברירת מחדל 20, מקסימום 100 (ערך גדול יותר מקטין ל-100). |
sort | לא | sort=fast מחזיר מיד, בלי מיון לפי רלוונטיות. בלי הפרמטר, התוצאות ממוינות לפי רלוונטיות. |
פלט
טקסט רגיל (UTF-8). שלוש שורות לכל תוצאה, בלי כותרות ובלי שורות נוספות. אם אין תוצאות, התשובה ריקה.
https://www.youtube.com/watch?v=Ct5Z1ld8hcI # שורה 1: קישור לסרטון
שיעור פרשת שבוע # שורה 2: שם הסרטון
שיעורי הרב יעקב יעקבזון # שורה 3: שם הערוץ
https://www.youtube.com/watch?v=... # התוצאה הבאה...
קוראים את הפלט בקבוצות של שלוש שורות. בכל קבוצה: קישור, שם סרטון, שם ערוץ.
דוגמאות קוד
מגבלות והגנות
קריאה בשנייהעד קריאה אחת בשנייה לכל כתובת IP. מעבר לכך מתקבל
429 עם Retry-After: 1.עד 100 תוצאותאי אפשר לבקש יותר מ-100 תוצאות לשאילתה.
הרשימה בשרת בלבדאין שום כתובת שמחזירה את הרשימה המלאה. החיפוש מתבצע בשרת בלבד.
קודי תשובה: 200 הצלחה (גם כשאין תוצאות), 400 חסר q, 429 יותר מדי בקשות, 503 עומס זמני.