AT AppointmentTrader
登录
当前在线  
Partner Programs API 集成 · 公开 REST

调用 AT
从任何地方。

一个经过身份验证的 REST 接口，涵盖 AppointmentTrader 上的每个预订、出价、交易和场地。纯 HTTPS，JSON 输入输出，错误格式可预测——与驱动 AT 网页应用的端点相同，供您的服务器使用。

阅读文档 获取 API 密钥
  • 120+公开端点
  • 99.9%正常运行时间，过去 12 个月
  • <120msp95 延迟，边缘
curl · 任意语言 JavaScript SDK Python SDK PHP SDK REST · JSON API key · HMAC Webhook · signed
运作方式

三步。一个密钥。 五分钟完成首次调用。

  1. 01

    获取 API 密钥

    免费、即时、范围限定。公开端点无需密钥；用户范围端点需要 API 密钥加每用户授权。无销售，无等待名单——表单位于 /api-documentation.

  2. 02

    调用 /v1/...

    纯 HTTPS，JSON 输入输出，错误格式可预测。AppointmentTrader 网页应用使用的所有内容都在这里，有文档、示例请求和响应模式。无 GraphQL 网关，无协议惊喜。

  3. 03

    需要在 AT 内部的 UI？

    切换路径。 应用开发路径 将您的应用包裹在 AT 外壳中——相同端点，加上 SDK、侧边栏入口和门户安装。

端点系列

六个接口。 一个契约。

完整参考

市场数据

公开
/v1/marketdata/get_world_top

热门城市、封面价格、填充率、近期交易。驱动 AT 公开展示的相同接口——支持 SSR，JSON 类型，分页。

出价与报价

API 密钥
/v1/concierge/categorize_request

提交买家意向，获取解析后的场地匹配。获取开放出价，提出反价，撤销出价。与应用内意向编辑器使用的格式相同。

交易

API 密钥
/v1/transaction/list

每用户认证的交易历史，按状态、日期范围、地点过滤。状态变更（已支付、已转让、已退款）的 Webhook 订阅。

地点

公开
/v1/location/search

场地搜索、自动完成、营业时间、容量、照片。驱动 AT 搜索栏的相同数据库——涵盖从餐厅到 DMV 预约的 12 个类别索引。

通知

API 密钥
/v1/notification/subscribe

每用户的推送、电子邮件、短信订阅。主题范围（出价成交、交易确认、消息接收）。出站标准 Webhook 签名。

用户与社交

API 密钥
/v1/user/get_profile

个人资料、评分、关注图谱、活动动态。公开接口只读；在带有效 SDK 令牌的应用托管 iframe 内调用时支持完整 CRUD。

120+
六个接口的公开端点
99.9%
12 个月正常运行时间，公开与认证接口
<120ms
来自边缘的 p95 延迟，覆盖所有区域
$0
免费套餐，无需信用卡即可开始
常见问题

诚实的答案。

费用是多少？

公共接口（市场数据、位置搜索）在合理使用范围内免费。用户范围端点——涉及真实用户预订的端点——每月前10,000次调用免费，之后按量计费。应用托管分发（您的应用内置于 /apps/{id}/) is free; we revenue-share only on transactions you originate.

速率限制是多少？

公共接口未认证时为每分钟60次请求。使用API密钥时为每分钟600次请求。用户范围端点对每个用户有滑动窗口限制；达到限制时软失败，持续滥用后硬失败。每个响应都包含 X-RateLimit-Remaining 和 X-RateLimit-Reset — no surprises.

有沙箱环境吗？

有。在任何端点后追加 ?sandbox=1 ，或访问同一路径的 sandbox.appointmenttrader.com. Same shapes, same auth, fixture data — transactions don't move real money, notifications don't ship to real users, and you can reset the world from the partner dashboard.

支持webhooks吗？

支持——HMAC签名，带退避重试，可从仪表板重放。按主题订阅（bid.filled, transaction.confirmed, message.received, etc.) with an API key plus a per-user grant. We deliver from a stable IP range you can allowlist; logs and replays live in the partner dashboard for 30 days.

什么时候应该切换到应用开发？

当您的用户在AppointmentTrader内时。直接API：您的应用，您的服务器，您的分发——用户从其设置中授权您的API密钥，您从自己拥有的后端调用 /v1/ 。 应用开发: your app loads inside an iframe on AT, gets a sidebar entry, an SDK token auto-issued for the active user, and ships into the user's portal beside our own surfaces. Same endpoints, same data, different reach — pick by where your users already are.

如何获取密钥？

/api-documentation#auth. Sign in to AT, click Generate, copy the key. The first request can land 30 seconds later. There's no review queue for the public tier; user-scoped grants flip on per-app review (typically same-day).

您的代码，我们的市场。 五分钟内开始。

免费套餐。无需信用卡。无销售电话。驱动AppointmentTrader所有功能的相同接口。

阅读文档 Back to Partner Programs

120+公共端点。99.9%正常运行时间。p95响应时间低于120毫秒。