Shopee虾皮API｜根据ItemID获取商品详情 完整对接教程
做Shopee店铺ERP、商品同步、价格监控、铺货系统，用得最多的就是【根据商品ID获取商品详情】接口。很多新手对接踩坑：只传itemid拿不到数据、签名报错、权限拦截、返回空、跨站点调取失败。
今天给大家整理一套Shopee官方 item/get 接口最简落地对接方案，参数、签名、请求地址、高频报错一次性讲透，直接照着写代码即可通调。
一、接口基础信息（官方唯一标准）
接口名称：item.get 获取商品详情
请求地址：https://partner.shopeemobile.com/api/v2/item/get
请求方式：GET / POST 均可
核心作用：传入 item_id + shop_id，返回商品标题、价格、库存、图片、规格、描述、类目、销量、状态等完整数据
二、必传参数（少一个直接失败）
Shopee和淘宝不一样，必须双ID校验：商品ID + 店铺ID，只传商品ID一定拿不到数据。
1. 公共鉴权参数（所有请求必带）公共参数：https://o0b.cn/JeO6y3
partner_id：开发者后台分配的Partner ID
timestamp：当前时间戳（秒级）
access_token：店铺授权Token（店铺级接口必须带）
sign：MD5签名
- 业务参数（商品详情专用）
item_id：Shopee商品ID（纯数字）
shop_id：对应商品所属店铺ID
重点总结：item_id + shop_id 一一对应，跨店铺调用直接返回空数据。
三、Shopee API 签名规则（90%报错根源）
Shopee签名逻辑比淘宝简单，但严格度更高，错一个字符直接 sign error。
签名拼接公式：
sign = MD5(secret + 排序后参数串 + secret)
规则细节：
所有参数按 key 字母升序排序
不包含空值参数
参数拼接格式 key=value
首尾包裹 Partner Secret
MD5结果小写（和淘宝相反）
四、最简可成功请求结构
参数顺序排序后示例：
access_token=xxx&item_id=xxx&partner_id=xxx&shop_id=xxx×tamp=xxx
套上secret做MD5，生成sign带入请求即可。
五、返回数据包含哪些字段（够用清单）
调通后可直接拿到完整商品字段，满足同步、铺货、监控全部场景：
商品基础：标题、简介、商品状态（上架/下架）
价格信息：原价、售价、活动价、折扣比例
库存数据：总库存、各规格库存
素材数据：主图、轮播图、视频、详情内容
SKU规格：多规格名称、价格、库存、编码
类目、销量、评分、发布时间
六、高频报错 & 精准解决（一线运维实测）
- sign_invalid 签名错误
原因：参数未排序、首尾没包secret、MD5大小写搞反、timestamp毫秒/秒级混用
解决：Shopee必须小写MD5 + 严格升序 + 秒级时间戳
- invalid_shop 店铺无效 / 数据空返回
原因：shop_id 和 item_id 不匹配、商品已下架删除、店铺未授权
解决：核对商品真实归属店铺，重新授权店铺token
- permission_denied 无权限
原因：应用未开通商品读取权限、token过期、授权失效
解决：后台开启 item 权限，重新生成店铺授权
- timestamp expired 时间戳过期
原因：本地时间偏差大、时间戳写死、缓存旧参数
解决：每次请求实时生成秒级时间戳
七、新手最容易踩的3个坑
只传item_id不传shop_id：Shopee所有商品隶属于店铺，单ID无法定位商品
混用测试环境/正式环境域名：必须用 partner.shopeemobile.com 官方合作域名
照搬淘宝签名逻辑：淘宝大写MD5，Shopee小写，直接照搬必报错
八、总结
Shopee根据ID获取商品详情接口，没有复杂逻辑，全部是规范问题。
只要记住：双ID必填、参数升序、小写签名、秒级时间戳、店铺Token有效，基本可以一次调通。
后续需要我可以补：批量采集写法、增量更新、价格库存监控逻辑、完整可运行代码片段。
#ShopeeAPI #虾皮开发 #item_get #商品详情接口 #ERP对接 #电商API #接口调试