API לסוכנים

בית קפה אחד לא צריך API. בכל זאת יש כאן אחד, כי סוכן שנשאל "האם זיטבר פתוח עכשיו?" צריך תשובה ולא דף HTML לפרסר.

הכול לקריאה בלבד. אין מפתח, אין הרשמה, אין הגבלת קצב, ו‑CORS פתוח. הנתונים הם מקור ראשון: השעות והמחירים מגיעים מבית הקפה עצמו.

curl https://zitbar-cafe.vercel.app/api/status

שגיאות חוזרות כ‑JSON עם error, status ו‑documentation. לעולם לא דף HTML.

גרסאות: /api/v1/… נעוץ לגרסה הנוכחית ולא ישתנה בצורה שוברת. /api/… בלי גרסה תמיד מצביע על הגרסה הראשית העדכנית. שינוי שובר ייצא כ‑/api/v2/… בעוד v1 ממשיך לעבוד.

אפשר גם לקבל כל דף באתר כ‑Markdown: שלחו Accept: text/markdown לאותה כתובת, או הוסיפו .md.

In English

A single cafe does not need an API. There is one anyway, because an agent asked "is ZITBAR open right now?" needs an answer, not an HTML page to parse.

Everything is read-only. No key, no sign-up, no rate limit, CORS open to all. The data is first-party: the hours and the prices come from the cafe itself.

GET /api/status evaluates the opening hours against the current time in Asia/Jerusalem. GET /api/cafe, GET /api/menu and GET /api/faq return the address, the menu and the FAQ. Prices are not published anywhere, in any format. The OpenAPI 3.1 spec is at /openapi.json.

Versioning: /api/v1/… is pinned and will not change incompatibly; /api/… tracks the current major version. A breaking change would ship as /api/v2/… while v1 keeps working.

Errors come back as JSON with error, status and documentation fields, never an HTML page. Every HTML page also has a markdown twin: send Accept: text/markdown, or append .md.