开放平台API接入实操

先说边界：小红书开放平台不面向普通个人开发者提供笔记/评论类接口的通用调用权限，它的设计对象是商家自研和服务商集成。理解这一点，再往下走资质和授权流程，会少走很多弯路。本文是小红书API全景指南的接入实操子页，按资质、OAuth2.0与首个请求的顺序展开。

第一步：选对资质类型

开放平台在创建应用前必须完成资质审核，入口在open.xiaohongshu.com。资质分两类：第三方开发者提交资质信息进入审核流程；商家自研跳转ARK商家系统，绑定店铺主账号完成资质绑定。选择取决于你要调用的接口类型：电商类接口（订单、商品、库存、售后）通常需要商家资质；内容类接口（笔记详情、评论列表）走第三方开发者或商家自研路径均可，但笔记详情接口明确不对个人开发者开放。企业主体需要营业执照，部分行业（美妆、食品、医美等）还需行业专项资质。审核通过后，在应用管理处获取client_id和client_secret，这是后续所有请求的身份基础。

第二步：走通OAuth2.0授权

授权分两步。第一步，将用户引导至授权页，回调地址会携带code和state参数返回。第二步，用code换取AccessToken。state用于防CSRF，回调时必须校验一致性；AccessToken有过期时间，服务端需要实现刷新逻辑，不能假设一次获取永久可用。

核心接口的基础域名是https://open.xiaohongshu.com，鉴权方式为请求头携带Bearer令牌。笔记详情走/api/v1/note/info，评论列表走/api/v1/note/comment/list，评论使用游标分页（cursor），循环拉取直到游标为空。

第三步：首次调用与限流应对

一个最小可用的Python调用结构如下（示意）：

真正的难点不在“调通”，而在持续稳定地调。官方对单应用有QPS限制，实测层面普遍指向QPS ≤ 5，安全阈值建议1秒1次；超限返回429，并可能触发IP封禁或Token失效。一条可直接采用的工程规则：每秒不超过2次请求，批量任务线程数控制在2个以内，遇到429立即停止3–5秒，cursor翻页必须串行而非并发。