小红书电商平台对接指南

1. 适用范围

本文适用于需要通过观远连接器同步小红书电商平台订单、售后、商品、库存、物流、财务等数据的商家。当前连接器采用小红书开放平台自研应用授权方式，客户需要准备自有小红书开放平台应用，并完成目标店铺授权。

开始前请确认：已有可登录的小红书开放平台账号；账号已完成平台要求的注册与认证；有权为目标店铺创建或管理自用型应用。

2. 申请平台对接资质

2.1 注册并进入小红书开放平台

1. 访问小红书电商开放平台首页，完成注册、登录和主体认证。
2. 根据使用场景选择自用型应用。自用型应用面向店铺自有系统对接，符合本连接器的自研应用接入方式。
3. 进入控制台的应用管理页，准备创建应用。

图：小红书开放平台公开页面展示的官方接入流程，包括注册认证、创建应用、开发测试和上架应用。实际页面及审核要求以平台最新规则为准。

2.2 创建自用型应用并开通权限

1. 前往小红书开放平台创建应用页，按页面要求填写应用名称、应用说明等资料。
2. 选择自用型应用，并根据需要同步的数据范围申请订单、售后、商品、库存、物流、财务等接口权限。
3. 提交平台审核。审核通过后，在“应用列表”中找到目标应用，点击“应用管理”，进入“App证书”区域查看凭证。
4. 官方页面中的 Appkey 与开放平台接口参数 appId 指向同一应用凭证；同时保存 App Secret，在连接器中填写为 appSecret。
5. 不要通过聊天、邮件或截图公开传递 appSecret；文档截图中如出现真实密钥，应先脱敏。

图：小红书开放平台官方“应用开发”文档中的 App 证书示例。示例 Appkey 已再次遮罩；App Secret 默认隐藏，点击“显示”或“重置”前需要使用开发者手机号完成短信验证。

2.3 需要保存的资质字段

前往小红书开放平台应用管理页查看 appId 与 appSecret

3. 创建连接器数据账户

3.1 打开数据账户创建页并选择平台

1. 在观远连接器中进入数据账户管理，点击新增数据账户。
2. 所属平台选择“小红书电商平台”。
3. 填写便于识别的账户名称，例如“小红书-品牌旗舰店”。

图：选择“小红书电商平台”后，表单要求填写账户名称、appId、appSecret 和 customerId，随后点击“立即授权”。

3.2 字段映射关系

3.3 授权、测试并保存

1. 核对账户名称、appId、appSecret 和唯一的 customerId。
2. 点击“立即授权”，在打开的小红书官方授权页面登录并选择目标店铺。可先查看小红书官方服务授权入口了解授权角色。
3. 确认授权范围与目标店铺无误后完成授权，返回连接器。
4. 授权状态显示完成后点击“确定”保存数据账户，再运行一次基础接口同步确认连接正常。

授权页面如提示无权限、主体未认证或应用尚未审核通过，请先回到小红书开放平台完成对应处理，不要重复创建数据账户规避平台校验。

4. 常见问题