Spring Boot商城对接小红书开放平台接口步骤

接到一个需求，需要对接小红书店铺（小红书千帆）的商品管理和发货到自有商城和ERP上，实现统一商品维护和发货。

搜了一圈发现没有太多对接的资料，以下是踩坑记录。

账号创建

首先先让运营注册好小红书店铺，并完成企业资质认证。

然后进入小红书开放平台 小红书-开放平台https://open.xiaohongshu.com/注册账号，直接绑定千帆即可自动完成企业认证。

（这点比抖音店铺好多了，抖店开发者账号居然还要上传软著和部分代码才能审核）

应用申请

打开 控制台 选择“新增应用”

应用类目选自营的即可。

开发对接

对接流程

首先要知道小红书鉴权流程是怎么样的。如果有对接过微信的相关接口比较好理解，小红书的应用就是服务商模式的，你自己开发的应用授权给店铺使用。所谓的自营应用只不过是自己授权给自己而已。

应用密钥

首先我们需要使用到应用的密钥，一个AppKey（AppId）和一个AppSecret，作用是计算出请求的签名（这一步SDK会处理）

店铺授权

为了获得操作店铺的权限，应用需要进行登录授权。

登录方法就是生成如下的登录页URL，然后用有权限的账号登录并授权，授权码将会回调到你填入的回调URL中。

https://ark.xiaohongshu.com/ark/authorization?appId=<你的APPID>&redirectUri=<回调URL>&state=<自定义参数>

授权页面

回调地址：

https://{回调地址redirectUri}/?code=74afa4f59c404***089e9db87797d6cc&state=1234

然后把code取出来就是授权码。（是不是有点像用户第三方登录的操作）

获取访问Token

到这步终于可以获取token了。用code在十分钟内调用“oauth.getAccessToken”方法，就可以换取到这个店铺专属的 accessToken 和 refreshToken。

其中文档里有有效期说明

注意事项：
        1)accessToken有效期为7天，refreshToken有效时间为14天
        2)accessToken未过期且剩余有效时间大于30分钟，使用refreshToken进行刷新后accessToken和refreshToken均不会刷新
        3)accessToken未过期且剩余有效时间小于30分钟，使用refreshToken进行刷新后会得到新的accessToken和refreshToken，且旧accessToken有效期为5分钟
        4)accessToken过期后使用refreshToken进行刷新后会得到新的accessToken和refreshToken
        5)refreshToken过期后需要通过用户重新授权
        6