申请 API 访问权限

票务与营销，
智能互联。

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

阅读快速入门 →示例在 Postman 中打开
18ms
P50 延迟
99.99%
2025 可用性
565
端点
10
章节
10 亿+
请求/年
●POST /terp/v1/import/ticketowners
curl {{API_BASE_URL}}/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl {{API_BASE_URL}}/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
演示系统
实时状态
正在检查…
API…
数据库…
响应时间…
上次检查: —
获得信赖并已集成于
Deutsche TelekomDeutsche MesseMesse FrankfurtMesse EssenMesse StuttgartDeutsche Landwirtschafts-Gesellschaft (DLG)NürnbergMesseMesse BremenMesse MünchenMesse Offenburg-OrtenauRX Global
专为技术决策者打造

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

专为 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
Quickstart

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

1

生成 token

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

2

发现活动

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

3

构建购物车

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

4

确认并交付

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

curl {{API_BASE_URL}}/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl {{API_BASE_URL}}/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
  1. 您的后端调用 ADITUS：
    Token
    POST /connect/token

    输入客户端凭证，获取短期 bearer token。密钥绝不会离开您的后端。

  2. 您的后端调用 ADITUS：
    发现活动
    GET /shop/v1/discovery/events

    包含活动、场次和价格组合的本地化目录。

  3. 您的后端调用 ADITUS：
    购物车——幂等
    POST /shop/v1/cart

    创建购物车、添加商品并关联买家。重试是安全的：仍为同一购物车，不会产生重复项。

  4. 您的后端调用 ADITUS：
    结账
    POST /shop/v1/cart/{id}/checkout

    锁定购物车并付款。响应中包含用于交付的 Quicodes 和票券链接。

  5. ADITUS 调用您的后端（异步）：
    Webhook异步
    POST https://your-backend/webhook

    每次购买成功后，ADITUS 都会异步调用您的端点，不受结账响应影响。

完整的端到端流程：四次同步出站调用，一次异步 Webhook 回调。
Shop Micro Frontend

票务商店，原生融入您的网站。

只需一次 mount() 调用，即可将完整购买流程（商品发现、购物车、注册、结账）直接嵌入您的页面：无 iframe，通过设计 token 呈现您的品牌风格，并原生支持本地化和响应式布局。

了解 Micro Frontend →
Experience Days 活动页面中的嵌入式票务商店，展示门票分类、商品详情、价格和数量选择
API 参考

所有端点，清晰分组。

从 OAuth token 到 Webhook 重放，共 10 个章节；每个请求都包含示例、标头和响应说明。

入门

ADITUS API 入门：了解平台涵盖的功能、各部分如何协同，以及从何处开始集成。

API 规范

API 规范：请求与 URI 的结构、Basic 或 OAuth 身份验证、HTTP 方法、状态码以及响应格式。

Just Entrance

ADITUS 硬件可与外部登记服务商配合使用。本节介绍连接外部系统、实现顺畅现场入场体验的不同方式。

示例：导入外部票券，自动核对并立即完成入场准备。

购票与登记

Shop API 涵盖完整的商店流程：查找商品和资源、管理用户、购物车及购买流程；Discovery 用于发现系统配置。

示例：在您的应用内完成完整购票流程——加载商品组合、填充购物车、收集买家信息并付款。

Byndr

Byndr 是一套产品 API，通过胸卡二维码扫描在活动参与者之间建立顺畅、安全的单向或双向连接。

问卷

问卷用于系统化收集数据，由一系列问题组成，可有针对性地收集访客信息并支持动态表单。

资源

请优先使用本 API，而不是已弃用的 Theme API。Assets API 提供图片、票券、凭证及主题配置等静态内容。

在实时演示中，我们将展示如何获取和使用资源等内容 →

Webhooks

Webhooks 将实时数据传送至外部系统，使应用、API 和网站能够响应 ADITUS 平台中的特定事件。

示例：入场扫描会实时触发 Webhook，Salesforce、HubSpot 等系统可自动启动后续流程。
查看所有章节 →
Live-Demo

亲自实时体验 API。

实时演示将引导您体验一个完整建模的展会活动，包括商品组合、票券、购物车和登记；每一步都会展示真实的 API 请求与实时响应，无需信用卡。

打开实时演示