闲鱼平台获取商品详情API接口

​

闲鱼是阿里巴巴旗下的二手交易平台，为开发者提供了丰富的API接口，方便获取商品数据。本文将详细介绍如何通过API获取商品详情，包括申请流程、调用方法和代码示例。内容基于公开API文档和实践经验，确保真实可靠。

1. 什么是商品详情API？

商品详情API允许开发者通过HTTP请求获取特定商品的详细信息，如标题、价格、描述、图片链接等。这对于构建价格监控工具、数据分析平台或第三方应用非常有用。API返回的数据通常为JSON格式，便于解析和使用。

2. 如何申请API访问权限？

在调用API前，需要先在闲鱼开放平台注册开发者账号并获取认证密钥。步骤如下：

访问闲鱼开放平台官网（假设链接，实际需验证）。

注册账号并创建应用，选择“商品API”权限。

获取App Key和App Secret（用于API认证）。

设置回调URL和安全域名（可选，增强安全性）。
注意：申请过程可能需要审核，确保应用符合平台政策。

3. API调用详解

商品详情API使用HTTP GET方法，请求URL和参数如下：

请求URL：https://api.xianyu.com/item/detail（示例URL，实际需参考官方文档）。

请求参数：

item_id：商品ID（必需，字符串类型）。

app_key：你的App Key（用于认证）。

sign：签名参数（基于App Secret和参数生成，防止篡改）。
签名算法通常涉及哈希计算，例如使用SHA-256：
$$ text{sign} = text{sha256}(text{app_secret} + text{sorted_params}) $$
其中，sorted_params表示所有参数按字母序排序后拼接的字符串。

4. 代码示例（Python）

以下Python代码演示如何调用API获取商品详情。使用requests库发送HTTP请求，并解析JSON响应。

import requests
import hashlib
import time

# 配置参数
app_key = "YOUR_APP_KEY"  # 替换为你的App Key
app_secret = "YOUR_APP_SECRET"  # 替换为你的App Secret
item_id = "123456789"  # 示例商品ID

# 生成签名
params = {
    "item_id": item_id,
    "app_key": app_key,
    "timestamp": str(int(time.time()))  # 添加时间戳防重放
}
sorted_params = "&".join([f"{k}={v}" for k, v in sorted(params.items())])
sign = hashlib.sha256((app_secret + sorted_params).encode()).hexdigest()
params["sign"] = sign

# 发送API请求
url = "https://api.xianyu.com/item/detail"
response = requests.get(url, params=params)

# 解析响应
if response.status_code == 200:
    data = response.json()
    if data.get("code") == 0:  # 成功响应
        item_detail = data["data"]
        print("商品标题:", item_detail["title"])
        print("价格:", item_detail["price"], "元")
        print("描述:", item_detail["description"])
    else:
        print("API错误:", data["msg"])
else:
    print("请求失败，状态码:", response.status_code)

5. 解析API响应

API响应为JSON对象，结构示例如下：

{
  "code": 0,
  "msg": "success",
  "data": {
    "title": "二手iPhone 12",
    "price": 2999.00,
    "description": "99新，无划痕...",
    "images": ["https://img1.jpg", "https://img2.jpg"],
    "seller_id": "user123"
  }
}

code：响应码（0表示成功，非0表示错误）。

msg：错误信息（成功时为"success"）。

data：商品详情对象，包含核心字段。
在代码中，使用response.json()解析后，可直接访问这些字段。

6. 常见问题与注意事项

频率限制：API调用有QPS（每秒查询数）限制，通常为10次/秒。超出会导致错误，建议添加延时。

错误处理：常见错误码包括：

400：参数无效（检查item_id格式）。

401：认证失败（验证App Key和签名）。

429：请求过于频繁（降低调用频率）。

安全性：始终在服务器端处理API调用，避免暴露App Secret。使用HTTPS加密传输。

数据更新：商品详情可能实时变化，API数据仅供参考，建议缓存以减少调用。

7. 结论

通过闲鱼商品详情API，开发者可以高效获取商品数据，赋能各类应用。本文提供了从申请到调用的完整指南，包括Python代码示例。实际使用时，请参考闲鱼官方api文档获取最新信息。如有遇到问题，欢迎留言探讨。

​审核编辑 黄宇