当前在线  
Partner Programs 应用开发 · iframe挂载

内嵌于
我们的壳层。

AT应用是您已熟悉的Web应用——在AppointmentTrader壳层内以干净的 /apps/{id} URL呈现,带侧边栏入口、主题同步和针对活跃用户的作用域SDK令牌。读取AT数据,出价,发布社区动态,安装到用户门户,置于我们界面旁。

  • iframe挂载于/apps/{id}
  • 0为旧模块重写
  • SDK针对活跃用户作用域
AT应用的实际工作方式

三步走。 一个清单。

  1. 01

    向清单添加条目

    将您的应用 ID、入口 URL 和菜单允许列表放入 /config/atv2-apps.php. The host page at /apps/{id}/{subpath} 呈现 v2 外壳,在侧边栏显示您的菜单,并嵌入您的 entryUrl 在沙箱 iframe 中。

  2. 02

    通过 SDK 使用 AT 数据

    第一方应用(同源)直接访问 /v1/... 使用用户会话。第三方应用(跨源)通过 postMessage 代理请求权限——同一个桥接用于发布、读取配置文件、交易查询。主题同步、导航和身份验证自动流转。

  3. 03

    安装到用户门户

    注册后,您的应用会作为一行出现在 AT 侧边栏——与首页、热门、卖家并列。用户以访问其他界面的方式进入。子路径更改通过 postMessage 传递;父页面控制地址栏,因此内部导航感觉原生,而非 iframe。

应用能做什么

六个基本功能。 所有 AT 数据均在范围内。

驱动 AppointmentTrader 的相同 API 接口,按您请求且用户授权的范围向您的应用开放。

读取 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)

第三方 · 酒店

酒店内部礼宾仪表盘——接收表单、奖励计算器、会员接送动态——为前台团队呈现。通过 SDK 与 AT 出价端点通信;将客人成交收据推送回物业 PMS。

Menu 未处理请求 · 已成交 · 团队

Encore Floor (partner sample)

第三方 · 餐厅

餐厅经理的“今晚释放座位”界面。实时列出 Encore 正在成交的座位、付款的食客、需更新的预订条目。SDK 令牌限定单一物业。

Menu 今晚 · 本周 · 报告

下一个是你吗?

空闲时段

一个尚不存在的界面——奢侈品牌的购物客户管理应用、俱乐部的预订未来仪表盘、场馆端针对每个物业出价的实时记录。

Menu 联系我们
0
代码重写以将遗留模块封装为应用
5s
SDK 握手预算,主机切换到错误前
2
信任等级——第一方(会话)和第三方(经纪人)
$0
分销费——仅对您发起的交易进行收入分成
构建定制工具的合作伙伴

销售的第二个工作台—— 您的设计。

当今应用开发最合适的场景是合作伙伴构建的内部工具:一个与 AT 出价对接的酒店礼宾仪表盘,一个展示今晚恢复预订的餐厅 Encore 楼层视图,一个让奢侈品牌管理 AT 活跃客户名单的销售界面。能力经纪人正是为此保留——合作伙伴应用在平台拥有的沙箱中请求 AT 提供的操作。

如果您已经在 ElevéEncore 项目中,内部应用是自然的下一步。您的团队构建界面;我们提供数据、认证和安装通道。

常见问题

诚实的答案。

应用开发与 API 集成有何不同?

API 集成是您的技术栈从外部调用 AT——您拥有 UI、用户和分发;您只需要 AT 数据。应用开发则相反:您在 AT 内部发布 UI——侧边栏入口、我们壳内的干净 URL、安装到用户门户。底层使用相同端点;覆盖范围不同。当您的用户已在 AT 上或您希望他们在时,这是正确的选择。

我的应用实际上可以读取或使用 AT 数据做什么?

任何 AT Web 应用能做的事,受限于用户授权。读取市场数据、位置搜索、公开资料。使用带范围的 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 并作为侧边栏行对所有人展示。基于数据库的注册表和每用户启用行正在开发中——用户将从发现界面安装,授权时审查权限范围,侧边栏入口将出现在其门户中,和首页、热门、卖家及合作伙伴并列。合作伙伴构建的内部工具按物业安装,不对其他租户可见。

我需要重写现有 Web 应用吗?

不需要。主机在 iframe 内提供您的 URL 时会剥离 v2 壳,并用最小信封包裹主体。相同的 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 保持地址准确。刷新、后退、深度链接——全部原生且干净。用户永远看不到 iframe 接缝。

通过 AT 分发成本是多少?

分发免费。我们仅对应用发起的交易进行收入分成——如果应用驱动的出价被 AT 成交,我们分成费用;如果应用纯工具不涉及资金流动,则无费用。API 免费额度(用户范围端点每月 1 万次调用)覆盖大多数内部合作伙伴工具端到端。无 SaaS,无按座位许可。

带来工具。 我们提供通道。

与合作伙伴负责人进行 20 分钟通话。我们将介绍清单、SDK、安装路径,以及您的用户在侧边栏实际看到的内容。

已加入 Elevé 或 Encore?内部应用是自然的下一步。 Back to Partner Programs.