京东(JD.com)作为一个大型电商平台,提供了丰富的API接口供开发者使用,以实现各种自动化和定制化功能。然而,直接提及一个名为 jd.item_search_img
的API可能并不完全准确,因为京东官方API的命名和具体功能可能会随时间变化,且不一定直接公开所有细节。不过,基于您的需求,我们可以假设 jd.item_search_img
是一个假设的或第三方提供的API,用于通过图片搜索京东上的商品。
虽然我不能直接给出 jd.item_search_img
的确切返回值结构,但我可以根据一般电商平台的图片搜索API来推测其可能的返回值内容。这些返回值通常会包含以下几类信息:
- 搜索结果列表:
- 商品ID:每个匹配商品的唯一标识符。
- 商品标题:商品的名称或简短描述。
- 商品图片URL:商品的图片链接,通常包括多张图片,但首图最常见。
- 商品价格:商品的当前售价,可能包括原价和促销价。
- 商品链接:点击后可以直接跳转到商品详情页的URL。
- 商品评分/评价数量:用户对商品的评价情况。
- 库存状态:商品是否有货。
- 分页信息(如果API支持分页):
- 当前页码:当前查询结果所在的页码。
- 总页数:搜索结果的总页数。
- 每页数量:每页显示的商品数量。
- 搜索建议或相关推荐(非必需):
- 可能基于用户上传的图片,给出一些搜索建议或相关商品的推荐。
- 状态码和消息:
- 状态码:表示请求是否成功,如200表示成功,4xx表示客户端错误,5xx表示服务器错误。
- 消息:对状态码的详细解释或错误信息。
- 其他元数据:
- 请求ID:唯一标识这次请求的ID,用于问题追踪或日志记录。
- 时间戳:请求被处理的时间。
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 | 卖家昵称 |