接口核心信息

• 接口名称： zkh.item_get（商品详情接口）
• 请求方式：GET
• 必填参数：
  • num_iid：商品ID（如  "AH0990"）
• 认证方式：
  • 需通过  API密钥（ key 参数） 进行身份验证。
  • 部分示例需额外提供  secret 参数（可能与密钥配对使用，需在控制台确认）。
• 接口功能：
  • 获取商品基本信息（标题、型号、规格）
  • 价格信息（原价、促销价）
  • 库存信息
  • 商品图片、卖家信息（店铺名称、ID）

调用步骤

1. 注册与获取API密钥

1. 访问震坤行API控制台：
   • 示例入口： https://api-gw.onebound.cn/zhenkunhang
2. 注册账号并创建应用：
   • 登录后，在“应用管理”中生成  app_key（API密钥）。
   • 部分接口需同时使用  secret 参数，需在控制台确认是否需要。

2. 构造请求URL

• 基础URL格式：

  plaintexthttps://api-gw.onebound.cn/zhenkunhang/item_get/?key=<app_key>&num_iid=<商品ID>

• 可选参数示例：
  • is_promotion=1：获取促销信息
  • cache=no：禁用缓存，确保获取最新数据

3. 发送请求

使用Python示例代码：

pythonimport requests# 配置参数url = "https://api-gw.onebound.cn/zhenkunhang/item_get/?key=YOUR_APP_KEY&num_iid=AH0990"response = requests.get(url)data = response.json()# 处理响应if data.get("error_code") == "0000":print("商品详情:", data["item"])else:print("请求失败:", data.get("error"))

使用cURL命令：

bashcurl -i "https://api-gw.onebound.cn/zhenkunhang/item_get/?key=YOUR_APP_KEY&num_iid=AH0990"

4. 处理响应

• 成功响应示例：

  json{"item": {"title": "AMMEX/爱马斯 一次性深蓝色丁、腈手套 APFNCHD44100 M 无粉麻面 1盒","price": "40.90","pic_url": "https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_01.jpg","num": 200,"specifications": "100只/盒 10盒/箱","seller_info": {"shop_name": "AMMEX/爱马斯","shop_id": 197570}},"error_code": "0000"}

• 错误处理：
  • 检查  error_code 字段（ "0000" 表示成功）。
  • 网络错误或参数错误时，返回详细错误信息。

注意事项

1. 频率限制：
   • 未明确提及调用频率上限，建议遵守平台规范，避免高频触发限流。
2. 数据缓存：
   • 通过  cache=no 参数禁用缓存，确保实时性。
3. 参数编码：
   • 部分示例显示参数已URL编码，需确认是否需要手动处理。

常见问题

• Q：如何获取商品ID？
  • A：商品ID（ num_iid）通常在商品页面URL中，例如：

    plaintexthttps://www.zkh.com/item/AH0990.html → AH0990

• Q：接口返回  "401 Unauthorized"？
  • A：检查API密钥是否正确，或是否遗漏  secret 参数（如需要）。

示例场景

• 获取商品促销信息：

  plaintexthttps://api-gw.onebound.cn/zhenkunhang/item_get/?key=YOUR_APP_KEY&num_iid=AH0990&is_promotion=1

通过以上步骤，您可快速调用震坤行商品详情接口，获取所需数据。如遇问题，建议查阅官方文档或联系技术支持。