导读微店商家做跨平台搬家、ERP 内部管理、分销选品首要就是商品详情接口。很多团队踩坑OAuth 授权、token 过期、SKU 嵌套解析、图片防盗链、限流 429。本文基于生产环境讲解微店官方商品详情 API 完整对接输出标准化可刊登数据集。o0b.cn/JeO6y3业务场景店铺搬家微店货源批量迁移 Temu、拼多多、视频号小店导出标题、SKU、库存、图片、运费信息ERP 多店管理自家微店商品同步内部 ERP库存、价格统一管控分销选品系统读取分销佣金、拼团活动筛选可分销商品商品监控监控价格变动、库存下架预警。权限约束个人开发者仅允许读取授权的自己店铺商品拉取第三方店铺商品需要企业资质提交场景审核个人账号不支持。简易技术实现思路【开发负责人阅读】鉴权层独立中控服务单独部署 token 中控服务处理 OAuth2 授权回调统一获取、刷新 access_tokentoken 持久化 Redis设置过期预警提前刷新业务 worker 全部从中控拿 token禁止各个业务节点各自获取 token防止 token 互相覆盖失效。存储 任务层MySQL 存储商品主表分表存储 SKU 子表MQ 承载商品 pid 任务队列Redis 做两层缓存①已处理 pid 去重②缓存商品详情热数据减少重复 API 调用冷热分离逻辑缓存命中直接读取存量未命中才发起 http 请求调用详情接口结果回写 Redis。调用 限流层令牌桶组件控制 QPS上限建议 5‑10QPS统一封装 http 客户端处理 429、5xx指数退避重试超过重试阈值写入死信队列支持单独重跑失败 pid不需要全量重跑埋点监控任务总数、成功量、失败率、token 剩余有效期。数据处理层转换组件价格单位分→元解析properties_name字符串拆分为结构化规格数组清洗 HTML 详情去除平台内部链接图片异步服务批量下载图片上传对象存储替换全部图片 URL类目映射服务微店类目 ID 映射目标平台类目路径输出刊登所需要素输出JSON对接 ERP 接口、Excel 模板运营导出。异常兜底token 失效事件回调通知死信队列失败商品支持后台页面查看、手动重试。接口基础信息接口地址https://open.weidian.com/api/v1/product/detail鉴权OAuth2.0请求携带access_token请求方式GET入参pid (商品 ID)access_token核心返回字段商品标题、价格 (分)、原价、总库存、HTML 详情、主图数组、sku 数组sku_id、规格、sku 价格、sku 库存、sku 图、是否包邮、运费模板 ID、销量、分销佣金、shop_id。⚠️价格单位为分业务系统务必除以 100 转为元是高频 BUG 来源。完整业务链路店铺搬家场景完整链路获取商品 ID 池 → OAuth 中控维护 access_token → MQ 任务分发 → Redis 缓存命中判断 → API 调用详情未命中 → SKU 图文解析 → 图片转存对象存储 → 文案清洗过滤 → 类目属性映射 → 输出刊登数据集获取商品 ID 池调用商品列表接口分页获取全部 pid推入 MQ列表接口只有简略字段不可直接刊登。access_token 生命周期管理由独立中控服务统一刷新、缓存 token业务节点只消费 token不发起授权获取避免 token 覆盖失效。任务消费与接口调用令牌桶限流Redis 做去重与热数据缓存429/5xx 自动重试失败进入死信队列。数据清洗解析价格单位转换SKU 规格字符串解析结构化HTML 详情过滤微店内部链接提取可用描述图片防盗链处理全部转存自有图床过滤微店营销、分销引导文案。类目映射微店内部类目映射目标平台类目路径补齐刊登必填属性。输出 JSON/Excel推送 ERP 草稿运营复核刊登。生产踩坑清单❌1、忽略价格单位 “分”价格数值放大 100 倍❌2、业务节点各自刷新 access_tokentoken 被覆盖大批量任务中途鉴权失败❌3、无 QPS 限流大量并发触发 429 接口封禁❌4、直接使用微店源站图片 URL刊登后图片空白❌5、个人账号尝试拉第三方店铺返回权限拒绝❌6、直接拿列表接口数据刊登字段不全审核驳回❌7、原样带入 HTML 详情内微店跳转链接触发目标平台风控拦截。性能指标参考自有店铺十万级搬品任务分发十万级 pid 入队分发 15‑25min接口 QPS5‑10QPS看应用权限冷热缓存优先读 Redis仅变更商品调用 API大幅降低接口消耗清洗后刊登通过率80% 以上。合规边界只能处理商家主动 OAuth 授权的店铺数据禁止未经许可拉取第三方店铺批量搬品素材需要差异化处理规避目标平台重复铺货API 返回数据仅限内部业务使用禁止对外售卖分发。总结微店商品详情 API 技术难点不在于接口本身核心工程点是OAuth token 生命周期管理、SKU 嵌套解析、单位转换、限流风控、图片防盗链迁移。大批量店铺搬家、ERP 同步要把重心放在整套缓存‑调度‑清洗‑映射链路而不是简单调用接口拿 JSON。