如何从 Tenor 的 V1 API 迁移

对于使用 Tenor 的 V1 API 的现有集成，请按照本页面上的步骤迁移到 V2。

获取 V2 API 密钥

按照快速入门指南的设置步骤中的说明获取 V2 API 密钥，以替换您的 V1 版本。

更新为 V2 网域

将 API 网域更新为 https://tenor.googleapis.com/v2/。Tenor 的 V2 API 仅支持 HTTPS 连接。对于内容，请确保您的应用支持从 https://media.tenor.com 和 https://c.tenor.com 下载内容。

例如，假设您向以下某个 V1 网域发出了 API 调用：

• https://api.tenor.com/v1/search?<parameters>
• https://g.tenor.com/v1/search?<parameters>

如需更新对 V2 的调用，请将其更改为 https://tenor.googleapis.com/v2/search?<parameters>。

端点更改

大多数 API 端点参数与 V1 中记录的参数相同。不过，也有一些值得注意的例外情况：

1. Tenor 的搜索端点现在支持通过 searchfilter 参数搜索贴纸。
2. 在 API 调用中添加 client_key 和 country 参数。
3. media_filter 参数现在接受以英文逗号分隔的所需格式列表，而不是预设的枚举。
4. “类别”端点现在支持 type 参数的 featured 和 trending。
5. 该 API 不再支持 anon_id 参数。
6. 当没有更多结果页可供请求时，API 响应的 next 字段现在为空字符串，而不是 "0"。

可用的端点已进行了以下更改：

1. 热门趋势端点已不再受支持。我们建议您改用精选端点。
2. GIF 端点已更名为帖子端点。
3. 随机 GIF 端点已通过 random 参数并入搜索端点。

响应对象和错误变更

• GIF 对象已更名为响应对象。
• 在响应对象中，media 字段已更名为 media_formats。media_formats 的值现在是映射 { CONTENT_FORMAT : MEDIA_OBJECT }，而不是映射数组。
• 内容缩略图预览已从每种内容格式的媒体对象移至其自己的格式。它们在响应对象的 media_formats 字段中提供。
• 如果响应对象中没有更多结果，则 next 字段为空字符串 ""，而不是 "0"。
• Tenor API 错误代码已迁移到 Google 的标准 API 错误代码。