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

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 的服务条款和相关法律法规，不得将数据用于非法或未经授权的用途，确保数据的合法获取和使用.