票务与营销，
智能互联。

一个 API 即可完成票券销售、入场管理和营销激活，同时提供 CTO 所期望的清晰度。

阅读快速入门 →示例在 Postman 中打开

18ms

P50 延迟

99.99%

2025 可用性

610

端点

章节

10 亿+

请求/年

●POST /connect/token · GET /shop/v1/discovery/events

curl https://aditus.dev/Demo_API/api/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl https://aditus.dev/Demo_API/api/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"

演示系统

实时状态

浏览器实时检查

ADITUS 公共演示系统为本门户中的所有交互式示例提供支持——活动发现、购物车、结账和票券都运行在真实的 Shop API 和实时数据库上。

此页面在浏览器中加载后，会立即实时检查 Shop API 及其上游服务的当前可用性以及响应时间。

页面加载时进行实时检查

获得信赖并已集成于

专为技术决策者打造

让您的集成团队真正受益的六项能力。

专为 CTO 和平台团队设计：身份验证、本地化、Webhooks 和幂等性，无需变通方案。

OAuth 2.0 客户端凭证

生成带有 Shop 或 TERP 等限定范围声明的短期 bearer token。可随时轮换，现有会话保持有效。

AUTH

原生支持本地化

传入 Accept-Language，即可获得所有文本字段的翻译结果。区域设置会贯穿购物车和结账流程。

i18n

Quicodes 与票券链接

只需一个标志即可生成可扫描的 QR payload。内置正则表达式类别会将扫描结果直接归类到报告中。

ACCESS

实时 Webhooks

涵盖票券、购物车、付款和入场的 30 种事件。使用 HMAC-SHA256 签名，并采用指数退避重试。

EVENTS

默认幂等

每次写入都带有 Idempotency-Key 标头。重复请求将返回原始响应和原始日志 ID。

RELIABILITY

营销级事件

通过 Webhooks 将转化和入场事件直接传输到 GA4、Meta CAPI 或您自己的数据仓库。

ACTIVATION

ADITUS 首席执行官 Marc Luzoff 的肖像 — **Marc Luzoff**CEO

Quickstart

只需四步即可上线，第五步完成付款。

生成 token

在 /connect/token 使用客户端凭证换取短期 bearer token，并缓存约 50 分钟。

发现活动

获取包含本地化名称、场次和价格组合的活动目录。可按日期、场馆和 slug 筛选。

构建购物车

创建幂等购物车，按商品 ID 或 slug 添加商品，关联客户并选择支付服务商。

确认并交付

锁定购物车、执行结账并接收 Quicodes 和票券链接。每次购买成功都会触发 Webhook。

curl https://aditus.dev/Demo_API/api/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl https://aditus.dev/Demo_API/api/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"

您的后端调用 ADITUS：
Token
POST /connect/token
输入客户端凭证，获取短期 bearer token。密钥绝不会离开您的后端。
您的后端调用 ADITUS：
发现活动
GET /shop/v1/discovery/events
包含活动、场次和价格组合的本地化目录。
您的后端调用 ADITUS：
购物车——幂等
POST /shop/v1/cart
创建购物车、添加商品并关联买家。重试是安全的：仍为同一购物车，不会产生重复项。
您的后端调用 ADITUS：
结账
POST /shop/v1/cart/{id}/checkout
锁定购物车并付款。响应中包含用于交付的 Quicodes 和票券链接。
ADITUS 调用您的后端（异步）：
Webhook异步
POST https://your-backend/webhook
每次购买成功后，ADITUS 都会异步调用您的端点，不受结账响应影响。