ממשק API

כל מה שנעשה במסך הניהול אפשר לעשות גם בקריאה רגילה: לקרוא את היומן, לראות אילו זמנים פנויים, לקבוע תור, להזיז אותו ולבטל אותו, ולנהל שירותים, שעות פתיחה וימי סגירה.

המפתח נשלח בכותרת Authorization, התשובות הן JSON, וכל שגיאה נושאת קוד יציב שאפשר להישען עליו בקוד — לצד הודעה באנגלית שנועדה ליומן השרת שלכם ולא למסך של לקוח. התיעוד נבנה ממסמך ה־OpenAPI שהשרת עצמו מפרסם, ולכן אינו יכול להתרחק ממה שרץ באמת.

תורים מגיש את אותן הפעולות גם בפרוטוקול MCP, כך שעוזר יכול לקרוא את היומן ולקבוע בו תורים בלי שאף אחד יכתוב קודם לקוח HTTP. זה אותו מפתח ואין מה להפעיל בנפרד — פרטי החיבור שכל לקוח MCP מבקש נמצאים בתיעוד.

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

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

כל הודעה חתומה, ונושאת מזהה משלוח שנשאר קבוע בכל ניסיון חוזר — אפשר להישען עליו כדי שאותו אירוע לא יטופל פעמיים. משלוח שנכשל חוזר בהשהיות הולכות וגדלות, והתוכן שנשלח הוא מה שהיה נכון ברגע האירוע, לא ברגע הניסיון.