Eventbrite

核心功能

Eventbrite Skill 提供完整的活动管理API集成，覆盖从创建到执行的全生命周期操作。用户可通过Maton托管OAuth网关，无需自建认证服务器即可调用Eventbrite原生API。

显著优点

• 托管OAuth降低门槛：自动处理token刷新和授权流程，开发者只需管理单个Maton API Key
• 全功能覆盖：支持事件CRUD、多票种定价策略、场地管理、订单追踪、参会者实时状态查询
• 企业级特性：支持多组织账号管理、批量分页查询、数据展开(expansion)减少API往返
• 多语言示例：提供Python、JavaScript、bash/curl完整代码片段，降低接入成本

潜在局限

• 依赖Maton服务可用性：网关单点故障将中断所有Eventbrite访问
• 速率限制：1000次/小时、48000次/天的配额对大型活动高峰期可能吃紧
• 货币精度陷阱：金额需以"USD,2500"格式传递（美分为单位），易因格式错误导致定价失误
• API演进追踪：Eventbrite已废弃用户级事件端点，需主动迁移到组织级端点

适合人群

• 活动科技公司整合票务能力
• 营销自动化团队同步活动数据到CRM
• 企业内部活动管理平台开发者
• 需要批量管理多组织账号的运营团队

常规风险提示

• 数据权限边界：OAuth授权范围需精确控制，避免过度索取组织级敏感数据
• 时间戳处理：跨时区事件需严格遵循ISO 8601 UTC格式，本地时区转换易引发调度事故
• 分页状态同步：continuation token有效期未明确文档化，长轮询场景需设计降级方案
• 废弃API依赖：Event Search API已关闭，现有集成需迁移到私有索引或第三方搜索方案

核心功能与用法

本 Skill 为 Maton 平台官方提供的 Eventbrite API 集成工具，通过托管 OAuth 机制实现与全球领先活动平台的深度对接。用户可通过统一的 Maton API 网关访问 Eventbrite 原生 API，无需自行处理复杂的 OAuth 授权流程。

核心能力覆盖：

• 活动全生命周期管理：从草稿创建、场馆配置、票种设置到发布/取消/删除的完整流程
• 组织架构管理：基于组织（Organization）维度的活动与场馆管理，支持多组织场景
• 票务与订单系统：票种创建与定价（支持免费/付费票）、订单查询、参会者状态追踪
• 参考数据访问：活动分类、格式、国家地区等元数据获取

技术集成特点：

• 所有请求通过 gateway.maton.ai/eventbrite/ 代理转发，自动注入 OAuth Token
• 支持连接多账户管理，可通过 Maton-Connection 头部指定特定连接
• 完整支持 Eventbrite API 的 Expansion 机制，减少请求次数
• 遵循 ISO 8601 时间格式与货币最小单位（美分）规范

显著优势

1. 零 OAuth 开发成本：Maton 平台托管 OAuth 流程，用户仅需获取 API Key 即可调用，省去应用注册、Token 刷新等繁琐工作
2. 企业级安全架构：所有通信强制 TLS 1.2+，API Key 通过环境变量管理，无硬编码凭证风险
3. 完整 API 覆盖度：涵盖 Eventbrite v3 API 核心能力，包括用户、组织、活动、场馆、票务、订单、参会者六大资源域
4. 多语言代码示例：提供 Python、JavaScript 等主流语言的调用示例，降低接入门槛

局限性与注意事项

1. 速率限制约束：Eventbrite 平台限制 1000 次/小时、48000 次/天，高频场景需实现退避重试
2. 搜索 API 不可用：Event Search API 已于 2020 年 2 月下线，无法通过 API 进行公开活动搜索
3. 组织强制依赖：活动创建必须归属组织， legacy 用户端点已废弃，需先获取 organization_id
4. 货币精度要求：价格字段使用"USD,2500"格式（2500 美分 = $25.00），易因格式错误导致创建失败
5. 连接状态依赖：OAuth 连接可能过期，需定期检查 ctrl.maton.ai/connections 状态

适用人群

• 活动运营团队：需要批量管理活动、监控票务销售与参会者数据的运营人员
• SaaS 开发者：构建活动管理功能、需要将 Eventbrite 数据同步至自有系统的开发者
• 市场营销自动化：集成活动数据至 CRM/营销自动化平台的工程师
• 多平台活动组织者：在 Eventbrite 与其他平台间同步活动信息的中间件开发者

风险评估

常规风险：

• OAuth 连接失效：连接过期或用户撤销授权将导致 API 返回 400 错误，需建立连接状态监控机制
• 速率限制触发：批量操作易触达 1000 次/小时限制，建议分页获取数据时控制并发
• 数据权限边界：通过 API 仅能访问已授权组织的数据，跨组织操作将返回 403

安全建议：

• 将 MATON_API_KEY 存储于权限 600 的配置文件，避免提交至版本控制
• 生产环境定期轮换 API Key，监控异常调用模式
• 敏感操作（如取消活动、删除票种）建议增加二次确认机制