闲鱼商品详情 API 接口返回的 JSON 数据示例如下（基于第三方服务商接口规范）：
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# API供应商demo url=o0b.cn/ibrad
# 请求示例 url 默认请求参数已经做URL编码
url = "https://#/goodfish/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=750828541223"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
关键字段说明：
- 状态信息：
code: 响应状态码（200 表示成功，400/500 等为错误代码）。message: 状态描述（如 "调用成功" 或具体错误原因）。
id: 商品唯一标识符。title: 商品标题。price: 当前售价（单位：元）。original_price: 原价（若存在折扣）。imageUrl: 主图 URL，支持多图时为数组格式。description: 商品描述（可能包含 HTML 标签）。location: 商品所在地。sales: 已售数量。status: 商品状态（在售、已售出、下架）。view_count: 浏览量。wish_count: 想要数。category: 商品分类路径。publish_time: 发布时间（格式：YYYY-MM-DD HH:MM:SS）。
nick: 卖家昵称。credit_level: 信用等级（极好、优秀、良好等）。good_rate: 好评率（百分比）。seller_id: 加密后的卖家 ID（需通过特定算法解密）。
promotions: 促销活动数组（如折扣、满减等）。
shortTpwd: 高佣转链 URL（2025 年 5 月新增，需结合转链接口使用）。
接口调用注意事项：
- 身份验证：
- 需提供
app_key（应用密钥）和sign（签名）。 - 签名生成规则：将请求参数按字典序排序，拼接成字符串后使用 MD5 或 HMAC-SHA256 算法加密。
- 必选参数：
num_iid（商品 ID）、timestamp（请求时间戳）。 - 可选参数：
cache（是否使用缓存）、lang（返回语言）等。
- 敏感信息（如卖家 ID）可能加密存储，需遵循平台解密规范。
- 使用 HTTPS 协议传输数据，避免中间人攻击。
- 频率限制：
- 接口调用频率可能受限，需控制请求速度以避免封禁。
示例代码（Python）：
import requests
import hashlib
def generate_sign(params, app_secret):
sorted_params = sorted(params.items(), key=lambda x: x[0])
sign_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params])
return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
def get_item_details(app_key, app_secret, item_id):
url = "https://api-gw.onebound.cn/goodfish/item_get/"
timestamp = "2025-10-13 14:50:00"
params = {
"key": app_key,
"num_iid": item_id,
"timestamp": timestamp,
"version": "1.0",
"cache": "no",
"result_type": "json",
"lang": "zh-CN"
}
params["sign"] = generate_sign(params, app_secret)
response = requests.get(url, params=params)
return response.json()
# 示例调用
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
item_id = "123456789"
result = get_item_details(app_key, app_secret, item_id)
print(result)数据来源说明：
- 上述示例基于第三方的接口规范，实际字段可能因接口版本或平台策略调整而变化。
- 若需获取官方接口，需通过闲鱼开放平台申请权限并遵守其开发者协议。需要处理分页逻辑（示例中未展示分页参数）建议包含错误处理机制.
.通过合理使用闲鱼item_get接口，开发者可高效获取闲鱼商品数据，结合业务场景构建智能电商应用。定期关注接口更新（如字段新增、权限调整），确保服务稳定性。
建议在使用前查阅最新接口文档，并进行充分的测试以确保数据准确性和稳定性。
