糖心Vlog API 面向开发者提供内容检索、分类聚合与元数据读取能力，接入域名为 api.tangxinmm.cloud。截至 2025 年 6 月，接口已覆盖糖心影视、糖心动漫、糖心视频三大内容板块，采用 HTTPS 传输与 Token 鉴权，支持 JSON 响应格式，帮助团队在自有应用中调取糖心传媒公开内容。
查看接入指南糖心Vlog API 是面向开发者开放的内容读取接口，域名 api.tangxinmm.cloud，提供目录、详情、搜索、分类四类端点，返回 JSON 数据。它不涉及用户账户体系，仅用于读取糖心传媒公开内容元信息。
接口按内容类型划分为若干命名空间，例如 糖心影视 下的剧集与影片目录、糖心动漫 下的番剧列表、糖心视频 下的短视频合集。每个端点均支持分页参数 page 与 size，单页最多返回 50 条记录。开发者可通过 category 参数按题材筛选，通过 keyword 参数进行标题模糊匹配。
申请糖心Vlog API 密钥需通过 api.tangxinmm.cloud 的开发者入口提交邮箱与应用名称，审核通过后获得 Client ID 与 Client Secret，再换取访问 Token。
鉴权流程分两步：先用 Client ID 与 Client Secret 调用 /oauth/token 获取 Bearer Token，再将 Token 放入后续请求的 Authorization 请求头。Token 默认有效期为 24 小时，过期后需重新获取。建议在服务端缓存 Token，避免每次请求都走鉴权流程。若返回 401，说明 Token 失效或格式错误；若返回 403，说明该 Token 无权访问目标端点。
糖心Vlog API 当前支持糖心影视、糖心动漫、糖心视频、糖心娱乐四大内容分类，对应目录、详情、搜索、分类四类端点，2025 年 6 月版本共开放 12 个公开端点。
目录端点用于拉取某一分类下的内容列表，详情端点用于获取单条内容的完整元数据，搜索端点支持按标题与标签检索，分类端点则返回题材标签树。以下为常用端点的用途说明：
所有端点共用同一套响应结构，data 字段在列表接口中为数组，在详情接口中为对象。字段命名统一采用小驼峰，时间字段使用 ISO 8601 格式。
接入糖心Vlog API 的典型场景包括站内搜索、内容聚合页、分类导航与数据看板，2025 年 6 月推荐使用服务端调用并缓存结果，避免前端暴露密钥。
以站内搜索为例，服务端接收用户关键词后，转发至 /v2/search 端点，将返回结果映射为本地数据结构，再渲染到页面。分类导航场景中，可先调用 /v2/category 获取标签树，再按标签调用 /v2/catalog 拉取内容。数据看板场景中，建议对目录接口做定时缓存，减少重复请求。
接入建议：密钥只放在服务端，前端通过自有后端转发请求；对高频端点做本地缓存，缓存时间建议 5 至 15 分钟；对 429 响应做退避重试，避免触发限流。
糖心Vlog API 内容速览覆盖接口规范、鉴权、端点与限流四部分，2025 年 6 月版本以 v2.3 为当前稳定版本。
域名、鉴权与响应结构的整体说明。
从 Client ID 到 Bearer Token 的完整步骤。
分页、排序与分类筛选参数一览。
标题、简介、年份、标签字段含义。
关键词检索与标签过滤的组合用法。
题材标签层级与前端筛选面板构建。
429 响应处理与请求频率控制策略。
401、403、404、429 的排查方向。
缓存时长与失效策略的落地建议。
v2.3 相对旧版的字段变化说明。
糖心Vlog API 是 api.tangxinmm.cloud 提供的公开内容读取接口，返回 JSON 数据，用于检索糖心传媒旗下内容元信息。
如果项目需要聚合糖心影视、糖心动漫等内容目录，接入可减少自建数据成本，2025 年 6 月版本接口结构稳定。
2025 年 6 月发布 v2.3 接口规范，后续版本更新会通过开发者公告与文档站点同步。
通过 api.tangxinmm.cloud 的开发者入口提交邮箱与应用名称，审核通过后获得 Client ID 与 Client Secret。
当前支持糖心影视、糖心动漫、糖心视频、糖心娱乐四大分类，共开放 12 个公开端点。
单 Token 每分钟 120 次请求，超出返回 429，建议做退避重试与本地缓存。
糖心Vlog API 开放接口与接入指南围绕 api.tangxinmm.cloud 展开，2025 年 6 月版本以 v2.3 为基准，覆盖鉴权、端点、限流与缓存四部分内容。
对于希望把 糖心影视、糖心动漫、糖心视频 内容引入自有应用的团队，建议先梳理业务所需的字段，再对照端点字典选择接口，避免一次性拉取过多数据。接入过程中，密钥管理、缓存策略与错误处理是三个容易出问题的环节，建议在测试环境完成联调后再上线。
文档站点会随接口版本同步更新，字段变更、端点调整与限流规则变化都会在更新日志中标注时间。开发者可结合本页内容速览中的十篇说明，按需查看具体环节的细节。