小红书库存API基础集成指南
电商管理系统如果没有正确集成小红书库存API，容易导致线上线下库存不同步，带来超卖损失。本文从认证授权、接口调用、数据同步三个维度，提供从0到1的集成方案，帮助开发者快速完成对接。
一、 认证与授权实现
OAuth2.0授权流程
1. 获取access_token：
1. 获取access_token：def get_token(app_id, app_secret):response = requests.post("https://openapi.xiaohongshu.com/oauth/token",data={"app_id": app_id,"app_secret": app_secret,"grant_type": "client_credentials"})return response.json()["access_token"] # 有效期2小时2. 签名生成算法：
import hashlibimport timedef generate_sign(params, secret):params["timestamp"] = str(int(time.time()))# 按key排序并拼接sorted_params = sorted(params.items(), key=lambda x: x[0])sign_str = "&".join([f"{k}={v}" for k, v in sorted_params]) + secretreturn hashlib.md5(sign_str.encode()).hexdigest().upper()二、 核心接口调用详解
库存查询与更新
1. 查询库存（GET）：
curl -H "Authorization: Bearer {token}" \"https://api.xiaohongshu.com/inventory?sku_id=SKU123"响应包含四个关键字段：
available：可售库存（total - reserved）
reserved：锁定库存（未支付订单）
standalone：渠道隔离库存（线上/线下）
total：总库存（available + reserved + standalone）
2. 更新库存（POST）：
{"sku_id": "SKU123","qty": 100,"operation": "set", // set/adjust"sign": "A1B2C3D4E5F6"}三、 数据同步策略
1. 实时同步方案
Webhook配置：订阅inventory.change事件，实时接收库存变更通知
本地缓存：Redis存储热点SKU库存（TTL=30秒），减少查询压力
2. 异常处理
错误码 | 处理方案 |
-5009025 | 检查SKU是否存在 |
-5009202 | 确保库存≥0 |
503 | 延迟30秒重试 |
四、 集成验收 checklist
1. token自动刷新机制（提前30分钟更新）
2. 签名算法正确性验证
3. 库存更新幂等性测试（重复调用不重复扣减）
4. 异常重试机制（限流/网络错误处理）