做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/JeO6y3partner_id开发者后台分配的Partner IDtimestamp当前时间戳秒级access_token店铺授权Token店铺级接口必须带signMD5签名业务参数商品详情专用item_idShopee商品ID纯数字shop_id对应商品所属店铺ID重点总结item_id shop_id 一一对应跨店铺调用直接返回空数据。三、Shopee API 签名规则90%报错根源Shopee签名逻辑比淘宝简单但严格度更高错一个字符直接 sign error。签名拼接公式sign MD5(secret 排序后参数串 secret)规则细节所有参数按 key 字母升序排序不包含空值参数参数拼接格式 keyvalue首尾包裹 Partner SecretMD5结果小写和淘宝相反四、最简可成功请求结构参数顺序排序后示例access_tokenxxxitem_idxxxpartner_idxxxshop_idxxxtimestampxxx套上secret做MD5生成sign带入请求即可。五、返回数据包含哪些字段够用清单调通后可直接拿到完整商品字段满足同步、铺货、监控全部场景商品基础标题、简介、商品状态上架/下架价格信息原价、售价、活动价、折扣比例库存数据总库存、各规格库存素材数据主图、轮播图、视频、详情内容SKU规格多规格名称、价格、库存、编码类目、销量、评分、发布时间六、高频报错 精准解决一线运维实测sign_invalid 签名错误原因参数未排序、首尾没包secret、MD5大小写搞反、timestamp毫秒/秒级混用解决Shopee必须小写MD5 严格升序 秒级时间戳invalid_shop 店铺无效 / 数据空返回原因shop_id 和 item_id 不匹配、商品已下架删除、店铺未授权解决核对商品真实归属店铺重新授权店铺tokenpermission_denied 无权限原因应用未开通商品读取权限、token过期、授权失效解决后台开启 item 权限重新生成店铺授权timestamp expired 时间戳过期原因本地时间偏差大、时间戳写死、缓存旧参数解决每次请求实时生成秒级时间戳七、新手最容易踩的3个坑只传item_id不传shop_idShopee所有商品隶属于店铺单ID无法定位商品混用测试环境/正式环境域名必须用 partner.shopeemobile.com 官方合作域名照搬淘宝签名逻辑淘宝大写MD5Shopee小写直接照搬必报错八、总结Shopee根据ID获取商品详情接口没有复杂逻辑全部是规范问题。只要记住双ID必填、参数升序、小写签名、秒级时间戳、店铺Token有效基本可以一次调通。后续需要我可以补批量采集写法、增量更新、价格库存监控逻辑、完整可运行代码片段。#ShopeeAPI #虾皮开发 #item_get #商品详情接口 #ERP对接 #电商API #接口调试
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/JeO6y3partner_id开发者后台分配的Partner IDtimestamp当前时间戳秒级access_token店铺授权Token店铺级接口必须带signMD5签名业务参数商品详情专用item_idShopee商品ID纯数字shop_id对应商品所属店铺ID重点总结item_id shop_id 一一对应跨店铺调用直接返回空数据。三、Shopee API 签名规则90%报错根源Shopee签名逻辑比淘宝简单但严格度更高错一个字符直接 sign error。签名拼接公式sign MD5(secret 排序后参数串 secret)规则细节所有参数按 key 字母升序排序不包含空值参数参数拼接格式 keyvalue首尾包裹 Partner SecretMD5结果小写和淘宝相反四、最简可成功请求结构参数顺序排序后示例access_tokenxxxitem_idxxxpartner_idxxxshop_idxxxtimestampxxx套上secret做MD5生成sign带入请求即可。五、返回数据包含哪些字段够用清单调通后可直接拿到完整商品字段满足同步、铺货、监控全部场景商品基础标题、简介、商品状态上架/下架价格信息原价、售价、活动价、折扣比例库存数据总库存、各规格库存素材数据主图、轮播图、视频、详情内容SKU规格多规格名称、价格、库存、编码类目、销量、评分、发布时间六、高频报错 精准解决一线运维实测sign_invalid 签名错误原因参数未排序、首尾没包secret、MD5大小写搞反、timestamp毫秒/秒级混用解决Shopee必须小写MD5 严格升序 秒级时间戳invalid_shop 店铺无效 / 数据空返回原因shop_id 和 item_id 不匹配、商品已下架删除、店铺未授权解决核对商品真实归属店铺重新授权店铺tokenpermission_denied 无权限原因应用未开通商品读取权限、token过期、授权失效解决后台开启 item 权限重新生成店铺授权timestamp expired 时间戳过期原因本地时间偏差大、时间戳写死、缓存旧参数解决每次请求实时生成秒级时间戳七、新手最容易踩的3个坑只传item_id不传shop_idShopee所有商品隶属于店铺单ID无法定位商品混用测试环境/正式环境域名必须用 partner.shopeemobile.com 官方合作域名照搬淘宝签名逻辑淘宝大写MD5Shopee小写直接照搬必报错八、总结Shopee根据ID获取商品详情接口没有复杂逻辑全部是规范问题。只要记住双ID必填、参数升序、小写签名、秒级时间戳、店铺Token有效基本可以一次调通。后续需要我可以补批量采集写法、增量更新、价格库存监控逻辑、完整可运行代码片段。#ShopeeAPI #虾皮开发 #item_get #商品详情接口 #ERP对接 #电商API #接口调试
