小红书笔记详情 API 数据结构与调用方式解析
小红书笔记详情 API 是面向官方合作方/授权开发者提供笔记核心数据的标准化接口，主要用于合规场景下的内容展示、数据分析（需授权）等需求。该接口的设计围绕数据标准化、权限管控、内容合规三大核心，其数据结构与调用方式具有鲜明的内容社区属性。
一、接口基础信息
1. 接口访问前提
- 权限限制：小红书笔记详情 API 不对外开放，仅对通过企业资质审核的合作方（如品牌服务商、合规内容平台）开放，个人开发者无法申请。
- 调用协议：支持 HTTPS 协议，保障数据传输安全；高并发场景可申请 gRPC 协议支持。
- 请求方式：以 GET 为主（只读查询），部分带用户个性化参数的请求支持 POST。
- 数据格式：默认返回 JSON 格式，支持 Protobuf 二进制格式（需申请开通，传输效率更高）。
2. 核心鉴权方式
小红书 API 采用双重鉴权机制，防止非法调用：
- 基础鉴权：AppKey + AppSecret 签名机制
- 开发者通过官方平台获取 AppKey（应用标识）和 AppSecret（密钥）。
- 请求时需对参数按规则排序，通过 HMAC-SHA256 算法生成签名（sign 参数），服务端校验签名有效性。
- 签名参数必须包含 timestamp（时间戳），且时间戳与服务器时间偏差不超过 ±5 分钟，防止重放攻击。
- 用户级鉴权：OAuth2.0 令牌机制
- 若需获取笔记的个性化数据（如用户是否点赞、收藏该笔记），需通过用户授权获取 access_token，并在请求头中携带。
二、核心数据结构
小红书笔记详情 API 返回的数据结构包含基础信息、内容信息、互动信息、作者信息四大模块，字段设计兼顾内容展示与合规要求。以下是标准化的 JSON 数据结构示例及字段说明：
{
"code": 0,
"msg": "success",
"data": {
"note_id": "648a7b2f0000000012345678",
"title": "夏日清爽穿搭指南 | 平价 T 恤分享",
"desc": "这几件 T 恤真的巨舒服！均价 50r，学生党冲...",
"content": "<p>哈喽姐妹们👋 今天给大家分享...</p>"
