מחוברים עכשיו  
Partner Programs פיתוח אפליקציות · מותקן ב-iframe

משלוח בתוך
העטיפה שלנו.

אפליקציית AT היא אפליקציית ווב שאתה כבר יודע לכתוב — מוצגת בתוך מעטפת AppointmentTrader בכתובת URL נקייה /apps/{id} עם כניסה בסרגל הצד, סינכרון נושא, ואסימון SDK ממוקד למשתמש הפעיל. קריאת נתוני AT, הצעת הצעות, פרסום לעדכון הקהילה, התקנה בפורטל המשתמש לצד הממשקים שלנו.

  • iframeמותקן ב-/apps/{id}
  • 0שכתוב למודולים ישנים
  • SDKממוקד למשתמש פעיל
איך אפליקציית AT עובדת בפועל

שלושה שלבים. מניפסט אחד.

  1. 01

    הוסף כניסה למניפסט

    הכנס את מזהה האפליקציה, כתובת הכניסה, ורשימת הרשאות לתפריט ל /config/atv2-apps.php. The host page at /apps/{id}/{subpath} מציג את מעטפת v2, מציג את התפריט שלך בסרגל הצד, ומשלב את ה entryUrl ב-iframe מבודד.

  2. 02

    השתמש בנתוני AT דרך ה-SDK

    אפליקציות מקור ראשוני (אותו מקור) פונות ל /v1/... ישירות עם מפגש המשתמש. אפליקציות צד שלישי (מקור שונה) מבקשות הרשאות דרך מתווך postMessage — אותו גשר שמאפשר פרסום, קריאת פרופילים, חיפוש עסקאות. סינכרון נושא, ניווט, ואימות מתבצעים אוטומטית.

  3. 03

    התקן בפורטל המשתמש

    לאחר רישום, האפליקציה שלך מופיעה כשורה בסרגל הצד של AT — לצד בית, פופולרי, מוכרים. משתמשים מנווטים אליה כמו לכל ממשק אחר. שינויים בתת-נתיב עוברים דרך postMessage; ההורה שולט בסרגל הכתובת כך שהניווט הפנימי מרגיש טבעי, לא בתוך iframe.

מה האפליקציה יכולה לעשות

שישה פרימיטיבים. כל נתוני AT בתחום ההגעה.

אותו ממשק API שמפעיל את AppointmentTrader, נחשף לאפליקציה שלך עם ההיקף שביקשת והמשתמש העניק.

קרא נתוני AT
/v1/marketdata/get_world_top · /v1/location/search · /v1/user/get_profile
ציבורי + מפתח API
הצע ומעקב הצעות
/v1/concierge/categorize_request · /v1/transaction/list
מפתח API + הרשאת משתמש
פרסם לעדכון החדשות
/v1/community/set_create_post · /v1/community/set_thumbs_up
מפתח API + אימות
הירשם לאירועים
/v1/notification/subscribe · bid.filled, transaction.confirmed (HMAC webhooks)
מפתח API + webhook
הצג במעטפת
iframe at /apps/{appId}/{subpath} · theme sync · nav allowlist
רק מניפסט
התקן בפורטל
sidebar entry · per-user enable rows (DB-backed registry, in progress)
מניפסט + סקירה
דחוף לקהילה

האפליקציה שלך מפרסמת ישירות לעדכון.

עדכון החדשות של קהילת AT הוא פשוט נקודת קצה נוספת. אפליקציה יכולה להרכיב פוסט, לצרף מדיה, להזכיר משתמשים, ולשלוח אותו — אותן מגבלות קצב, אותם שערי אימות, אותו עורך שהפלטפורמה משתמשת בו פנימית. בוט הצעות מודיע על מילוי. כלי נאמנות חוגג את העסקה ה-100 של אורח. ווידג'ט Encore מפרסם את כיסוי הלילה שהושג.

POST /v1/community/set_create_post

הגבלת עורך של 15 שניות למפגש · שער אימות חשבון · זהה לעורך בתוך האפליקציה.

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

אפליקציות שכבר פועלות

שלוש שלנו. שתיים שלהם. מקום פתוח אחד.

סקירת מארח אפליקציות

עסקאות

מקור ראשון

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

Menu פעילות · דוחות · קבלות

צ׳אט

מקור ראשון

הודעות קונה/מוכר קשורות לעסקאות חיות. אותו מודל iframe: מודול ישן מוצג מחדש בתוך /apps/chat/ ללא שכתוב, מקבל מתג נושא וניווט פנימי בחינם.

Menu תיבת דואר · שרשורים

התראות

מקור ראשון

מרכז התראות מערכת רחב של משתמש — הצעת מחיר מולאה, עסקה אושרה, הודעה התקבלה. מנוי לאותם נושאי /v1/notification שכל אפליקציית צד שלישי יכולה.

Menu הכל · אזכורים · הגדרות

דלפק קונסיירז' (partner sample)

צד שלישי · מלון

לוח קונסיירז' פנימי של מלון — טופס קבלה, מחשבון תגמולים, עדכון חברים — מוצג לצוות הקבלה. מתקשר עם נקודות הצעת המחיר של AT דרך ה-SDK; דוחף קבלות מילוי אורחים חזרה למערכת ניהול הנכס.

Menu בקשות פתוחות · מלא · צוות

Encore Floor (partner sample)

צד שלישי · מסעדה

ממשק מנהל מסעדה ל'שחרור מקומות הערב'. מציג בזמן אמת מה Encore ממלא, הסועדים ששילמו, איזו הזמנה לעדכן. אסימון SDK ממוקד לנכס יחיד.

Menu הערב · השבוע · דוחות

שלך הבא?

מקום פתוח

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

Menu דבר איתנו
0
שכתוב קוד לעטיפת מודול ישן כאפליקציה
5s
תקציב לחיבור SDK לפני שהמארח עובר לשגיאה
2
רמות אמון — מקור ראשון (מפגש) וצד שלישי (מתווך)
$0
עמלת הפצה — שיתוף הכנסות רק על עסקאות שאתה יוזם
שותפים בונים כלים מותאמים

דלפק שני למכירות — העיצוב שלך.

ההתאמה הברורה ביותר לפיתוח אפליקציות היום היא כלים פנימיים שנבנו על ידי שותפים: לוח קונסיירז' למלון שמדבר עם הצעות AT, תצוגת רצפת Encore למסעדה שמציגה את כיסוי הלילה שהושג, ממשק מכירות שמאפשר לבית יוקרה לנהל רשימת אורחים פעילים ב-AT. מתווך היכולות שמור בדיוק לכך — אפליקציות שותפים שמבקשות פעולות מסופקות על ידי AT בסנדבוקס שבבעלות הפלטפורמה.

אם אתה כבר ב Elevé או Encore בתוכניות, אפליקציה פנימית היא הצעד הבא הטבעי. הצוות שלך בונה את הממשק; אנחנו חושפים את הנתונים, האימות, ומסלול ההתקנה.

שאלות נפוצות

התשובות הכנות.

איך פיתוח אפליקציות שונה משילוב API?

שילוב API הוא הסטאק שלך שקורא ל-AT מבחוץ — אתה הבעלים של הממשק, המשתמשים, ההפצה; אתה רק רוצה נתוני AT. פיתוח אפליקציות הוא ההפך: אתה משגר ממשק בתוך AT — כניסה בסרגל הצד, כתובת URL נקייה בתוך המעטפת שלנו, התקנה בפורטל המשתמש. אותן נקודות קצה מתחת למכסה המנוע; טווח שונה. הקריאה הנכונה כשמשתמשיך כבר חיים ב-AT או שאתה רוצה שהם יהיו.

מה האפליקציה שלי יכולה לקרוא או לעשות עם נתוני AT?

כל דבר שאפליקציית הווב של AT עושה, בהתאם למה שהמשתמש העניק. קריאת נתוני שוק, חיפוש מיקום, פרופילים ציבוריים. עם מפתח API ממוקד ותעודת משתמש: הצעת הצעות, צפייה בעסקאות, מנוי לנושאי webhook, פרסום לעדכון הקהילה בשם המשתמש. היכולות מוגדרות במניפסט האפליקציה ומוענקות בהתקנה — המשתמשים רואים את אותם תחומים שאתה משגר איתם, ומבטלים ממסך יחיד.

האם האפליקציה שלי יכולה לפרסם לעדכון החדשות של AT?

כן. POST /v1/community/set_create_post עם {boardId, title, body} — the same endpoint the in-app composer uses. The post arrives with the user’s name on it (your app posts on their behalf, not as itself), and the same per-session 15-second throttle and account-verification gates apply. Apps that need to ship public-feed updates are exactly what this surface was built for.

איך משתמשים מתקינים אפליקציה בפועל?

כיום, אפליקציות רשומות חיות ב /config/atv2-apps.php ומופיעות כשורות בסרגל הצד לכולם. רישום מבוסס DB עם שורות הפעלה לכל משתמש בתהליך — משתמשים יתקינו מממשק גילוי, תחומי הרשאה ייבחנו בזמן ההענקה, וכניסת סרגל הצד תופיע בפורטל שלהם לצד בית, פופולרי, מוכרים ושותפים. לכלים פנימיים של שותפים, ההתקנה היא לנכס ולא נראית לשוכרים אחרים.

האם אני צריך לשכתב את אפליקציית הווב הקיימת שלי?

לא. המארח מסיר את מעטפת v2 כשמשרת את ה-URL שלך בתוך ה-iframe ועוטף את הגוף במעטפה מינימלית. אותו index.php מתמודד עם מצב דף מלא ומצב הטמעה — אפילו לא צריך לזהות ?embed=1. We literally wrapped three legacy modules (Transactions, Chat, Notifications) as v2 apps on day one with no code changes. The bridge script is auto-injected; you only ship one if you’re cross-origin.

איך סרגל הכתובת של ה-iframe עובד?

המארח שולט בו. כתובות URL תמיד קוראות /apps/{appId}/{subpath} — never the iframe’s real origin. Your app emits a {type:'navigated', path} postMessage כשמשנים נתיבים; ההורה קורא ל history.pushState כדי לשמור על הכתובת מדויקת. רענונים, כפתור חזור, קישורים עמוקים — כולם טבעיים ונקיים. המשתמש אף פעם לא רואה תפר בין iframes.

כמה עולה להפיץ דרך AT?

הפצה חינמית. אנו משתפים הכנסות רק על עסקאות שאפליקציה יוזמת — אם האפליקציה מייצרת הצעה ש-AT ממלא, אנו מחלקים את העמלה; אם האפליקציה היא רק כלי שאינו מזיז כסף, אין חיוב. שכבת חינם ב-API (10k קריאות לחודש בנקודות קצה ממוקדות משתמש) מכסה את רוב הכלים הפנימיים של השותפים מקצה לקצה. ללא SaaS, ללא רישיון למושב.

תביא כלי. אנחנו מביאים את המסילה.

שיחת 20 דקות עם ראש השותפויות. נעבור על המניפסט, ה-SDK, מסלול ההתקנה, ומה המשתמשים שלך יראו בסרגל הצד.

כבר ב-Elevé או Encore? אפליקציה פנימית היא הצעד הבא הטבעי. Back to Partner Programs.