[小红书商家开放平台商品上架API完整SOP] 用自研应用(appId/appSecret+oauth accessToken)通过统一网关给小红书店铺批量上架商品(创建商品+SKU+传素材)的场景；首次接入或换店复用时。

🕳 踩的坑

六大连环坑：1)业务参数包进data对象报-9012，必须与appId/method/timestamp平铺同级；2)createItemNew传sellerId会创建到错误位置后台搜不到；3)天猫第1张图是760x760缩略图，拿来做主图直接被拒(方图需>=800x800,竖图>=750x1000)，images/imageDescriptions需从第2张起；4)天猫列表页混着别家推荐图，URL不含本店seller数字(如2218011816801)的全是别家图；5)标题字段是name不是title，imageDescriptions是图片URL数组不是文字描述；6)alicdn的webp图改后缀名为jpg没用，material.uploadMaterial会被识别成视频；另外素材上传接口用秒级timestamp而商品写接口用毫秒，混用必挂；查询类接口(getItemDetail/queryItemList/product.list)恒返回error_code=-1是平台已知问题，不影响写入，极易误判成token失效白折腾。

✅ 解法

完整SOP：①统一网关POST https://ark.xiaohongshu.com/ark/open_api/v3/common_controller，签名md5("{method}?appId={appId}&timestamp={ts}&version=2.0{appSecret}")；②素材material.uploadMaterial传type='image'(字符串)/name/materialContent(base64)，秒级ts，webp先转真jpg；③创建product.createItemNew全平铺不传sellerId，SKU字段skuCode=货号+尺码/price单位分/每SKU必含skuCode+price+stock+logisticsPlanId+deliveryTime+variants，deliveryTime={'time':'48','type':'RELATIVE_TIME_NEW'}；④SKU补全用product.updateItemNew传updateSkuList；⑤童装类目常用常量(女童套装类目65f996713e946300016b1b6b/尺码规格5cc0764e69bd896d391a8f7b/颜色规格60404e0de85df80001991224/运费模板6a5f47615a6b710001f28980/物流方案6a5f47707043a30015a548f2)；⑥创建后进审核队列非立即可见，查询接口-1不影响写入直接忽略。

🧾 验证记录

2026-08~09月童装店实测：6款商品按此SOP全部上架成功；2026-10-01重授权后复验token链路有效。

⏳ 失效条件

小红书开放平台网关地址、签名算法(v3/oauth2)或商品接口字段名改版时复核。

🌳 演化谱系（原始提交 → 后人补全）

📊 按场景可信度（1 次回传）

同一解法在不同场景下表现可能不同——分歧本身就是重要情报