כניסה לאירוע
API ניהול אורחים —
הרשימה מתמלאת מהמערכת שלכם.
כל בקשה נחתמת ב-HMAC ויוצאת מהשרת שלכם: בדיקת מצב ההרשמה, ואז רישום האורח. ומי שלא צריך קוד — מטמיע את טופס ההרשמה בשורה אחת.
בדלת
ההרשמה מתבצעת באתר שלנו, והרשימה במערכת האירועים תמיד צעד אחריה.
הרשימה מתעדכנת פעם ביום, בייצוא ידני, ובדרך כלל אחרי שכבר שלחתם משהו על סמך המספרים הישנים.
בקשות חתומות
כל בקשה נחתמת ב-HMAC-SHA256 מהשרת שלכם, בחלון של חמש דקות סביב חותמת הזמן.
מפתח לכל אירוע
המפתח מונפק במסך ההגדרות ומזהה בעצמו את האירוע, והסוד מוצג במערכת פעם אחת בלבד.
בדיקה ואז רישום
GET status מחזיר אם ההרשמה פתוחה וכמה מקומות נותרו (כשהוגדרה מכסה לאירוע); POST register רושם את האורח באירועים ללא תשלום. באירוע שמוכר כרטיסים בתשלום ההרשמה מסתיימת בעמוד התשלום שלנו, ורשומת האורח נוצרת אחרי החיוב.
שדות הטופס מגיעים מהמערכת
שדות הטופס שנבנו במערכת חוזרים בתשובת status, כך שהוספת שדה לא מחייבת פריסה אצלכם.
שליפה לפי טלפון
מפתח כלל-חשבון שולף את רשומות האורח לפי מספר טלפון באירועים פעילים שעוזר הווטסאפ מופעל בהם, ומעדכן בהם אישור הגעה — למעט אירועים עם כרטיסים בתשלום, שבהם התשלום עצמו הוא האישור.
טופס להטמעה
שורת סקריפט אחת מטמיעה את טופס ההרשמה בכל אתר, עם התאמת גובה אוטומטית.
איך זה עובד
בארבעה שלבים.
מנפיקים מפתח
בהגדרות ← מפתחות API. הסוד מוצג פעם אחת.
חותמים
HMAC-SHA256 על חותמת זמן, שיטה, נתיב וגוף הבקשה.
שולחים
status לפני הצגת הטופס, register בהגשה.
עוקבים
הקונסולה מציגה מתי כל מפתח שימש לאחרונה.
שאלות נפוצות
מה שואלים אותנו לפני שמחברים מערכות.
אפשר לדחוף אורחים מהמערכת שלנו לרשימה?
תלוי במצב האירוע. באירוע עם הרשמה פתוחה לכולם — כן: POST /api/v1/register, בקשה חתומה אחת לכל אורח, עד 10 בקשות בשעה מאותה כתובת IP. באירוע שעובד מול רשימת מספרים מאושרים, מספר שאינו ברשימה חוזר עם not_on_list ונשמר למסך "ממתינים" לאישור ידני — כדי לדחוף אורחים ישירות צריך שהמספר כבר יהיה ברשימה המאושרת. לטעינה חד־פעמית של רשימה קיימת עדיף להעלות קובץ אקסל במערכת — אין נקודת קצה לשליחה מרובה. באירוע ללא תשלום אותו מספר טלפון פעמיים מחזיר already_registered ולא יוצר כפילות, כך שניסיון חוזר אחרי תקלת רשת בטוח. באירוע עם כרטיסים בתשלום קריאה חוזרת נחשבת בכוונה לרכישה נוספת ופותחת הזמנה חדשה — שם צריך לבדוק את תוצאת הקריאה הקודמת לפני שחוזרים עליה.
יש webhooks, או דרך למשוך את הרשימה?
אין webhooks יוצאים, ואין נקודת קצה שמחזירה את כל הרשימה. עם מפתח כלל-חשבון אפשר לשלוף את רשומות האורח לפי מספר טלפון ולעדכן אישור הגעה. ייצוא מלא של הרשימה נעשה מהקונסולה.
אפשר להטמיע את טופס ההרשמה באתר שלנו?
כן — שורת סקריפט אחת עם מזהה האירוע מטמיעה את הטופס ב-iframe, בכל דומיין, עם התאמת גובה לתוכן. בחירה בכרטיס בתשלום יוצאת מהמסגרת לעמוד תשלום מלא. את העיצוב קובעים בבונה הטפסים — צבעי הטקסט, השדות והכפתור נשמרים על האירוע והטופס המוטמע מציג בדיוק את מה שמציג עמוד ההרשמה עצמו, כך שהוא לא מתיישן אחרי שינוי עיצוב.
מה עושים אם מפתח דלף?
משביתים או מוחקים אותו במסך ההגדרות ומנפיקים חדש — בקשה חתומה במפתח מושבת נדחית. הסוד מוצג פעם אחת בהנפקה, ולכן הנפקה מחדש היא גם דרך השחזור. החתימה נעשית תמיד בשרת שלכם, אף פעם לא בדפדפן.
קשור לזה
עוד במערכת
רוצים לחבר את המערכת שלכם?
פתחו חשבון, הנפיקו מפתח ובדקו מול אירוע אמיתי — בלי התחייבות.
