1688商品详情数据接口(1688.item_get)丨1688API接入指南

36 阅读3分钟

1688 商品详情数据接口(1688.item_get)是阿里巴巴提供给开发者的 API 接口,用于获取 1688 网站上商品的详细信息. 以下是对该接口的详细介绍:

调用前准备

  • 注册成为开发者:需要在阿里巴巴开放平台注册账号,并创建一个应用,以获取 API 调用所需的凭证,如 App Key 和 App Secret.请求demo示例地址:c0b.cc/R4rbK2 。
  • 申请 API 调用权限:根据应用需求,申请相应的 API 调用权限,可能需要经过阿里巴巴的审核和授权.

请求参数

  • app_key:必填参数,用于标识应用程序,需向 1688 申请唯一的 app_key.
  • format:必填参数,返回数据的格式,通常为 json.
  • timestamp:必填参数,请求的时间戳,防止请求被缓存或重复执行.
  • nonce:必填参数,随机字符串,用于增加请求的安全性.
  • sign_method:必填参数,签名方法,目前仅支持 RSA 签名方法。
  • sign:必填参数,签名结果,确保请求的安全性,防止被篡改.
  • access_id:必填参数,1688 分配给每个开发者的唯一标识符.
  • fields:可选参数,商品详情页需要展示的字段,如商品名称、价格、库存、图片等,可根据需要选择.
  • key 或 num_iid:可选参数,商品的 key 值或 ID,用于指定获取哪个商品的详情信息.
  • sales_data:可选参数,设置为 1 时可获取近 30 天成交数据.
  • agent:可选参数,设置为 1 时可获取 1688 分销代发价格数据.

返回结果

成功调用接口后,将收到一个包含商品详情的 JSON 响应,响应中包含的字段与请求参数中 fields 指定的字段相对应1. 以下是一些常见的返回字段:

  • num_iid:商品 ID。
  • title:商品名称。
  • desc_short:商品简短描述。
  • price:商品价格。
  • total_price:商品总价。
  • suggestive_price:建议价格。
  • orginal_price:原价。
  • nick:卖家昵称。
  • num:商品库存数量。
  • detail_url:商品详情页的 URL。
  • pic_url:商品图片的 URL。
  • brand:品牌名称。
  • brandid:品牌 ID。
  • rootcatid:根类目 ID。
  • cid:类目 ID。
  • desc:商品详细描述。
  • item_imgs:商品图片列表。
  • item_weight:商品重量。
  • post_fee:邮费。
  • express_fee:快递费。
  • ems_fee:EMS 费。
  • shipping_to:发货地。
  • video:商品视频。
  • sample_id:样品 ID。
  • props_name:商品属性名称。
  • prop_imgs:属性图片。
  • property_alias:属性别名。
  • props:商品属性列表。

注意事项

  • 调用频率限制:接口的使用可能会受到频率限制,在实际应用中需要注意控制请求频率,避免触发限制,以免影响正常使用或导致账号被封禁等问题.
  • 接口更新:由于阿里巴巴平台可能会对接口进行更新,建议定期查看官方的 API 文档,以获取最新的接口信息,确保接口的正确使用.
  • 遵守规定:在使用接口时,必须遵守 1688 的服务条款和相关法律法规,不得将数据用于非法或未经授权的用途,确保数据的合法获取和使用.