Bored API — תיעוד

סקירה כללית

ה-API מוגש דרך Cloudflare Workers ומחזיר תשובות בפורמט JSON מתוך מאגר של 1000 פעילויות בעברית. כל הנתיבים תחת /api תומכים אך ורק ב-GET. עמוד התיעוד הזה מוגש בנפרד (למשל דרך GitHub Pages) — כתובת ה-API עצמה היא כתובת ה-Worker שקיבלתם מ-wrangler deploy.

מבנה פעילות

{
  "key": 100123,
  "activity": "ציור בצבעי מים",
  "type": "אמנות ויצירה",
  "duration": 1.5,
  "kidfriendly": true
}

שדה	תיאור
key	מזהה ייחודי (100000–100999)
activity	תיאור הפעילות
type	קטגוריה
duration	משך משוער בשעות
kidfriendly	האם מתאים לילדים (true/false)

הגבלת קצב

כל בקשה תחת /api/* מוגבלת ל-50 בקשות ל-15 דקות לפי כתובת IP. כל תגובה כוללת את הכותרות x-ratelimit-limit, x-ratelimit-remaining ו-x-ratelimit-reset. בעת חריגה מוחזר 429 עם כותרת retry-after (שניות עד לאיפוס).

נקודות קצה

GET /api/random

מחזיר פעילות אקראית אחת. אפשר גם לבקש פעילות ספציפית לפי מזהה עם ?key= — במקרה הזה שאר הפרמטרים מתעלמים:

פרמטר	תיאור	דוגמה
`key`	מזהה פעילות ספציפי — מחזיר אותה במקום פעילות אקראית	`?key=100123`
`type`	קטגוריה מדויקת	`?type=ספורט וכושר`
`kidFriendly`	`true` / `false`	`?kidFriendly=true`
`maxDuration`	משך מקסימלי בשעות	`?maxDuration=1`

curl "https://your-worker.workers.dev/api/random?key=100123"
curl "https://your-worker.workers.dev/api/random?kidFriendly=true&maxDuration=1"

GET /api/activities/:key

מחזיר פעילות ספציפית לפי מזהה.

curl "https://your-worker.workers.dev/api/activities/100000"

GET /api/activities

מחזיר את כל 1000 הפעילויות.

GET /api/types

מחזיר רשימה של כל הקטגוריות הקיימות.

curl "https://your-worker.workers.dev/api/types"

נסה עכשיו

קריאה חיה ל-/api/random. הדביקו כאן את כתובת ה-Worker שלכם (מודפסת בסיום wrangler deploy) — נשמר בדפדפן שלכם לפעם הבאה.