מפתחים
REST API ציבורי למועדונים ולשותפים מוסמכים: קריאות מוגבלות להיקף, הזמנות דרך API ו-Webhooks חתומים ב-HMAC.
אימות
כל מפתח נוצר מלוח הבקרה של המועדון, תחת ניהול → API ו-webhooks, ונשלח ככותרת Bearer.
curl -H "Authorization: Bearer mp_…" \
https://api.meetandplay.mx/api/v1/clubs/{clubId}/bookingsהמפתח המלא מוצג פעם אחת בלבד. שמרו אותו במקום בטוח.
נקודות קצה
כל מפתח מצהיר על ההיקפים (scopes) שאיתם נוצר; בקשה בלי ההיקף הנדרש נדחית.
- GET
/clubs/{clubId}/courtsקטלוג המגרשים של המועדון.
- GET
/clubs/{clubId}/availabilityחלונות תפוסים לכל מגרש, עד 14 ימים.
- GET
/clubs/{clubId}/bookingsההזמנות של המועדון, החדשות ראשונות.
- GET
/clubs/{clubId}/customersמדריך הלקוחות של המועדון — נתונים אישיים, תחת היקף נפרד משלו.
- POST
/clubs/{clubId}/bookingsיוצר הזמנה, בדיוק כמו הדלפק של המועדון עצמו.
- POST
/clubs/{clubId}/bookings/{bookingId}/cancelמבטל הזמנה; מחזיר או מבטל את התשלום לפי מדיניות המועדון.
וובהוקים
קבלו אירועים חתומים ב-HMAC-SHA256 לכתובת URL משלכם: הזמנה שנוצרה, אושרה או בוטלה, תשלום שהצליח, ומשחק שהתמלא. כל משלוח נשלח מחדש עם השהיה גדלה; אחרי כמה ניסיונות כושלים הוא נכנס לתור הודעות מתות (dead-letter), וניתן לשלוח אותו מחדש מלוח הבקרה של המועדון.
אימות Webhook
בנוסף לחתימת ה-HMAC (x-map-signature), כל Webhook יכול לשלוח כותרת Authorization, או Basic (שם משתמש וסיסמה) או Bearer (אסימון). מגדירים אותה בלוח הבקרה של המועדון, תחת ניהול → API ו-webhooks, באימות של כל Webhook. הפרטים נשמרים מוצפנים ולא מוצגים שוב.
POST https://…/webhooks x-map-signature: t=1767225600,v1=… x-map-delivery: 0199… Authorization: Bearer …
- היא נשלחת בכל משלוח, כולל ניסיונות חוזרים ומשלוחים מחדש מתור ההודעות המתות, עם הפרטים העדכניים ברגע השליחה: אם תשנו או תסירו אותם, השינוי חל גם על משלוחים שכבר בתור. אם השרת לא מצליח לפענח את הפרטים, המשלוח לא נשלח בלעדיהם; הוא עובר לתור ההודעות המתות. אם תשנו את ה-URL או תמחקו את ה-Webhook, משלוחים שהמתינו בתור ל-URL הישן מבוטלים או עוברים לתור ההודעות המתות: הפרטים אף פעם לא נשלחים ל-URL שכבר אינו רשום אצלכם.
- אנחנו עדיין ממליצים לאמת את חתימת ה-HMAC: כותרת Authorization אומרת מי קורא, אבל רק החתימה מוכיחה שהגוף לא שונה, והחותמת הזמן שלה (t=) מאפשרת לדחות משלוחים שהושמעו מחדש.
- לא עוקבים אחרי הפניות: תגובת 3xx נחשבת למשלוח כושל ונשלחת מחדש, כך שהפרטים אף פעם לא עוברים ל-URL אחר. רשמו את ה-URL הסופי של המקלט שלכם.
מגבלות קצב
לכל מפתח יש תקרת בקשות לדקה. תגובת 429 אומרת שהגעתם אליה; האטו ונסו שוב.
שותפים מוסמכים
שותף מוסמך מתחבר בלחיצה אחת מלוח הבקרה של המועדון — בלי להעתיק ולהדביק מפתחות ביד.
מוכנים לשלב את המועדון שלכם?
התחברו ללוח הבקרה של המועדון והפיקו את המפתח הראשון שלכם תחת ניהול → API ו-webhooks.