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

最新推荐文章于 2024-07-22 18:42:23 发布

api茶飘香

最新推荐文章于 2024-07-22 18:42:23 发布

阅读量608

点赞数 23

分类专栏：电商api 文章标签： java spring 开发语言大数据 python pygame 后端

本文链接：https://blog.csdn.net/apixixi/article/details/139826805

版权

278 篇文章 2 订阅

订阅专栏

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

一、概述

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

二、返回值详解

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

公共参数

请求地址:

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

三、实战指南

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

关注