ticketmaster-api

用途

本技能用于与 Ticketmaster Discovery API 集成，适用于以下场景：搜索演唱会、体育赛事和娱乐活动；构建活动发现应用；将票务信息集成到网站或应用中；查找场馆及其详情；搜索艺人、运动队和景点；实现基于位置的活动搜索；展示活动图片和价格信息；构建活动日历和列表。

主要能力

Ticketmaster Discovery API 提供对覆盖多个国家（美国、加拿大、墨西哥、澳大利亚、新西兰、英国、爱尔兰及其他欧洲国家）超过 230,000 个活动的综合数据库的访问。数据来源包括 Ticketmaster、Universe、FrontGate Tickets 和 Ticketmaster Resale (TMR)。

核心端点包括：

• 搜索活动：GET /discovery/v2/events，支持关键词、艺人 ID、场馆 ID、城市、国家代码、州代码、邮编、分类名称、DMA ID、起止日期时间、分页和排序等参数。
• 获取活动详情：GET /discovery/v2/events/{id}
• 获取活动图片：GET /discovery/v2/events/{id}/images
• 搜索艺人：GET /discovery/v2/attractions
• 搜索场馆：GET /discovery/v2/venues
• 获取分类：GET /discovery/v2/classifications
• 搜索建议：GET /discovery/v2/suggest

排序选项包括名称、日期、相关性、距离、场馆名称、开售日期和随机排序。

使用方式

基础 URL 为 https://app.ticketmaster.com/{package}/{version}/{resource}.json?apikey={YOUR_KEY}。Discovery API v2 的基础 URL 为 https://app.ticketmaster.com/discovery/v2/。

认证方式：访问 https://developer.ticketmaster.com/ 注册并获取 API 密钥，密钥会立即在仪表板中提供。所有请求都需要在查询参数中附加 apikey。示例：

curl 'https://app.ticketmaster.com/discovery/v2/events.json?apikey=AbCdEfGh123456'

速率限制：默认每日配额为 5,000 次 API 调用，速率为每秒 5 个请求，分页限制为 size × page < 1,000。响应头会显示使用情况：Rate-Limit（每日总配额）、Rate-Limit-Available（剩余请求数）、Rate-Limit-Reset（配额重置的 UTC 时间戳）。超出限制会返回 HTTP 429 响应。如需提高限制，需证明遵守服务条款、遵循品牌指南、正确展示数据，并联系 Ticketmaster 开发者支持。

适用场景

• 按位置查找活动：使用城市参数搜索特定城市的活动。
• 地理半径搜索：使用邮编、半径和单位（英里或公里）查找附近活动，并按距离排序。
• 按分类筛选：使用 classificationName 和 genreId 搜索特定类型的活动。
• 日期范围搜索：使用 ISO 8601 格式的 startDateTime 和 endDateTime 查找特定时间段内的活动。
• 获取活动详情与图片：通过活动 ID 获取完整信息，并选择最高分辨率的图片。
• 基于坐标的搜索：使用 latlong 参数和半径进行搜索。

限制

• 所有请求必须提供有效的 API 密钥，否则返回 Invalid ApiKey 错误。
• 默认每日配额为 5,000 次调用，速率为每秒 5 个请求，分页限制为 size × page < 1,000。
• 超出速率限制会返回 HTTP 429 错误。
• 提高限制需要联系 Ticketmaster 开发者支持并满足相关要求。
• 资料中未提供价格、收费或付费方案的具体信息。
• 资料中未提供官方文档之外的额外功能或效果保证。