京东拍立淘API（jd.item_search_img）返回值实战指南

京东拍立淘API（jd.item_search_img）返回值实战指南如下：

一、概述

京东拍立淘API（jd.item_search_img）是一个基于图像识别技术的搜索工具，允许用户通过上传图片或输入图片URL来快速找到京东平台上的相关商品。API的返回值是一个结构化的JSON数据，包含了与上传图片相似的商品列表及相关的详细信息。

二、返回值详解

1. 请求状态（status）
   • 通常是一个数字，表示请求的状态。例如，200通常表示请求成功。
2. 消息描述（message）
   • 描述请求状态的文本消息。如果status为200，则message可能是“Success”。
3. 结果集（result）
   • 一个数组，包含了与上传图片相似的商品信息。每个商品信息都是一个对象，包含以下字段：
     • sku_id：商品的SKU ID，用于唯一标识商品。
     • product_name：商品名称。
     • product_image（或image_url）：商品的图片URL，允许用户直接查看商品图片。
     • price：商品价格，可能包含小数点后的数字，如199.99。
     • rating：商品评分（如果有的话），通常是一个介于1到5之间的数字，如4.8。
     • sales_count：商品销量（如果有的话），可能是一个较大的数字，如10000。
     • ...：其他可能的字段，具体取决于API的文档，可能包括商品的详细描述、品牌、颜色、尺寸等信息。
4. 错误信息（error）
   • 如果请求失败，这里可能会包含有关错误的详细信息。在请求成功的情况下，error字段通常是null。

item_search_img-按图搜索京东商品（拍立淘）

jd.item_search_img

公共参数

请求地址: 

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：imgid=https://img13.360buyimg.com/n1/jfs/t1/227724/13/10901/137957/658ce427F3fa0fecd/e310c1eae499d322.jpg

参数说明：imgid:图片url（京东格式）

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	41142424134	宝贝ID
title	String	0	时尚收腰圆领短袖收腰蝙蝠袖纯色百搭2019年夏季连衣裙. 白色 S	商品标题
pic_url	String	0	//img14.360buyimg.com/n0/jfs/t1/31127/1/342/52750/5c3b2c12E466d12c0/47c72f9c99dd2feb.jpg	宝贝图片
promotion_price	Float	0	236.00	优惠价
price	Float	0	236.00	价格
sales	Int	0		销量
sample_id	Bigint	0		商品风格标识ID
post_fee	Float	0		物流费用
area	String	0		店铺所在地
seller	String	0		卖家昵称

 

三、实战指南

1. 准备阶段
   • 在京东开放平台注册账号，创建应用并获取API密钥。
   • 准备一张用于搜索的商品图片，这张图片可以是商品的实物图、图案或Logo等。
2. 调用阶段
   • 根据京东提供的文档和API密钥，调用图片搜索API接口。可以使用HTTP POST或GET请求方式。
   • 将图片数据发送给接口服务器，可以通过上传图片文件或提供图片的URL来实现。
3. 处理返回数据
   • 在客户端接收服务器返回的JSON数据。
   • 遍历result数组，获取每个商品的信息，并在应用中进行展示、处理或进一步的操作。
   • 注意检查status和error字段，确保请求成功并正确处理任何可能出现的错误。
4. 注意事项
   • 遵守京东的使用条款和政策，特别是关于数据隐私和版权的规定。
   • 根据需要，可以使用php、java、c、python等开发语言对京东图片搜索接口进行封装，以便于在应用程序中使用。