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:商品属性列表。