小红书 / RedNote 笔记开放接口集成教程

了解如何通过 TapSave 开放接口解析公开的小红书 / RedNote 笔记链接，并在应用中安全处理实际返回的媒体资源。

接入流程

向 https://api.videotool.cc/openapi/parse 发送 POST 请求，设置 Content-Type: application/json、X-API-Key 请求头，并在 JSON 请求体中传入公开链接字段 url。

响应处理

先检查 code === 200、data.resultCode === 0 和 data.hasResource === true。随后只处理本次响应实际返回的资源数组；不要自行拼接链接，也不要假定固定格式。

小红书 / RedNote 资源

小红书笔记可包含图片包、视频与文案；分别使用 imgList、videoList 和 descList，并处理多图为空的情况。开放接口还会在上游提供时返回独立元数据：author（作者昵称）、publishTime（发布时间，格式 yyyy-MM-dd HH:mm:ss）和 publishTimestamp（发布时间戳，单位：秒）。这些字段可为空，descList 保持原样以兼容已有接入。

限制与安全

API Key 必须保存在服务端，不能暴露在浏览器代码中。私密、删除、受限或不可访问的链接应作为预期的解析失败处理。