API + MCP

הקטלוג פתוח. לא צריך לבקש רשות.

פרקים, הרצאות ודוברים - ב-REST API וב-MCP. לקריאה בלבד. בלי API key, בלי OAuth, בלי להעמיד פנים שזה SaaS.

נקודת כניסה

https://outside-the-box.dev/api/v1

מכאן אפשר לגלות את כל המשטח. מי שרוצה חוזה מלא, לוקח את OpenAPI 3.1. מי שעובד עם סוכן, מתחיל ב-MCP של הקטלוג.

Method	נתיב	מה מקבלים
`GET`	`/api/v1`	API service descriptor and links to every integration surface.
`GET`	`/api/v1/episodes`	List episodes, newest first.
`GET`	`/api/v1/episodes/{id}`	Get one episode by slug or episode number.
`GET`	`/api/v1/talks`	List meetup talks, newest first.
`GET`	`/api/v1/talks/{id}`	Get one meetup talk by id.
`GET`	`/api/v1/speakers`	List podcast guests and meetup speakers.
`GET`	`/api/v1/speakers/{slug}`	Get one speaker and their appearances.
`GET`	`/api/v1/meetups`	List meetup events.
`GET`	`/api/v1/search`	Search episodes and talks in Hebrew or English.
`POST`	`/api/v1/batch`	Read up to 100 mixed records in one request.
`POST`	`/api/v1/exports`	Start a full-catalogue export job.
`GET`	`/api/v1/exports/{id}`	Poll an export job until it is complete.

כל רשימה מחזירה data ו-pagination. מעבירים את nextCursor לבקשה הבאה. גם כותרת Link עם rel=next שם.

שגיאות REST מחזירות application/problem+json עם code, detail ו-hint. אין HTML שצריך לגרד. ב-429 מחכים לפי Retry-After.

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

שני השרתים משתמשים ב-Streamable HTTP. שולחים אליהם JSON-RPC 2.0 ב-POST. שניהם ציבוריים ו-read-only.