摘要
在二手 ERP、鱼小铺店铺管理、二手货源监控、商品素材归档等项目开发 中，很多开发者希望获取闲鱼商品结构化详情数据。这里有一个核心前提：闲鱼 TOP 开放平台没有对外提供可以随意读取全网任意陌生人商品的通用详情接口。
本文完整解析官方 goodfish.item_get 接口，包含接口基础信息、请求参数、返回 JSON 样例、字段释义、错误码、开发流程和线上踩坑经验。
一、接口基础信息
1.公共请求参数
参数名 类型 必填 说明
method string 是 固定值 alibaba.idle.isv.item.query
app_key string 是 TOP 开放平台分配的 ISV 应用密钥
timestamp string 是 GMT+8 时区，格式yyyy‑MM‑dd HH:mm:ss；时间误差不可超过 10 分钟
v string 是 协议版本，固定2.0
sign_method string 是 签名算法，hmac‑sha256 /md5
sign string 是 加密生成的签名字符串
session string 是 店铺托管授权 OAuth session，必填，无托管授权调用直接报错
2.接口基础信息
项目 说明
接口 Method goodfish.item_get（前往Taobaoapi2014体验）
请求方式 GET / POST，生产环境推荐 POST
鉴权方式 app_key + app_secret + OAuth session 授权；必须完成店铺托管授权
签名算法 md5 /hmac‑sha256；参数按 ASCII 字典序升序生成 sign 签名
协议版本 v2.0
返回格式 JSON / XML，项目开发优先 JSON
硬性边界 只能查询该应用托管的闲鱼 / 鱼小铺商品；外部陌生人商品直接返回查询失败；需要闲管家 ISV 服务商资质。
3.业务入参
参数名 类型 必填 说明
item_id long 是 闲鱼商品 ID，来自托管店铺商品列表接口alibaba.idle.isv.item.list.query返回
need_sku boolean 否 是否返回 SKU 信息，不需要传 false，减少接口响应耗时
