API 概述:1688 商品详情 API 旨在为开发者提供精准、全面的 1688 平台商品信息,涵盖商品基础属性、价格体系、库存状况、图片展示、描述详情以及商家相关信息等多维度数据。通过调用该接口,开发者能够在自有系统中完整呈现 1688 商品的全貌。
请求方式:通常支持 HTTP GET 和 POST 两种请求方式。GET 请求简洁直观,适用于简单参数传递且对数据安全性要求不高的场景。POST 请求在处理复杂参数、传输大量数据以及保障数据安全方面更具优势,建议获取商品详情时使用 POST 请求,以确保数据传递的完整性与稳定性。
请求参数:主要包括 app_key、format、timestamp、nonce、sign_method、sign、access_id 等必填参数,用于标识应用程序、指定返回数据格式、确保请求安全等。此外,还有 fields、key 或 num_iid、sales_data 等可选参数,可用于指定商品详情页需要展示的字段、获取近 30 天成交数据等。
详情图获取:通过 1688 商品详情 API,可以获取商品的主图、细节图、多角度展示图等详情图链接。API 会以数组形式返回商品图片列表,开发者从返回的 JSON 数据中解析出图片链接字段,即可获取到详情图资源,如 item_imgs 字段可能包含多个图片链接,每个链接对应一张详情图。
返回结果:成功调用接口后,将收到包含商品详情的 JSON 响应。常见返回字段有 num_iid(商品 ID)、title(商品名称)、price(商品价格)、num(商品库存数量)、detail_url(商品详情页的 URL)、pic_url(商品图片的 URL)、brand(品牌名称)、desc(商品详细描述)、item_imgs(商品图片列表)等。