条码查询

一、接口描述

1. 功能描述

根据商品条形码查询商品信息,包括商品条码,名称,参考价等。

2. 能力说明

1.商品条形码,支持UPC-A、UPC-E、EAN-13、EAN-8等

3. 接口使用

使用接口前,需要先完成API的下单购买,然后可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程

二、请求说明

1. 接口地址

https://aiapi.jd.com/WinWin/item_product_get

2. 请求方式

 post

3. 请求参数

(1)query请求参数

公共请求参数

名称 类型 必填 示例值 描述
appkey string 80d2b762ecb86593f9668526920f46c 您的appkey,可在买家中心控制台中获
timestamp long 1541491668060 请求的时间戳,精确到毫秒,timestamp有效期5分钟
sign string 2e148773a0337a8f2200ba90d445f083 签名,根据规则MD5(sectetkey+timestamp)

(2)body请求参数

业务请求参数

名称 类型 必填 示例值 描述
product_id string 6934522809831 商品条形码

三、返回说明

1、返回参数

(1)公共返回参数

名称 类型 示例值 描述
code string 1000 参见下方错误码-系统级错误码
charge boolean false 或 true false:不扣费, true:扣费
remainTimes long 1305 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1
remainSeconds long 1223456 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1
msg string 查询成功 参见下方错误码-系统级错误码数
result object {...} 查询结果

(2)业务返回参数

名称 类型 示例值 描述
product_id string 6934522809831 商品条形码
title string 农心吸汗巾NX-9831 商品标题
price float 18.8 参考价格
charset string UTF-8 字符集
version string 1.0.0 接口版本
sign_type string MD5 签名类型,取值:MD5,默认:MD5
nonce_str string 5de7152b09c11 随机字符串
return_code string SUCCESS 通讯状态
result_code string SUCCESS 查询结果
appid string 12028093 应用id
sign string D08685C1979E619DEB1AE08CB0BBFBFD 签名结果

2、返回示例

{
    "code": "10000",
    "charge": true,
    "remain": 96,
    "remainTimes": 96,
    "remainSeconds": -1,
    "msg": "查询成功,扣费",
    "result": {
        "product_id": "6934522809831",
        "title": "农心吸汗巾NX-9831",
        "price": "18.8",
        "charset": "UTF-8",
        "version": "1.0.0",
        "sign_type": "MD5",
        "nonce_str": "5de7152b09c11",
        "return_code": "SUCCESS",
        "result_code": "SUCCESS",
        "appid": "12028093",
        "sign": "D08685C1979E619DEB1AE08CB0BBFBFD"
    }
}

四、错误码

1.系统级错误码

详见返回码

2.业务错误码

err_code err_code_des
DATA_PARSE_FAIL 数据格式错误
INVALID_REQUEST 请求参数错误
APP_NOT_FOUND appid 不存在
SERVER_ERROR 服务器错误
APP_DOES_NOT_HAVE_SCOPE app 没有相应权限
SIGNATURE_MISMATCH 签名不匹配
PRODUCT_NOT_FOUND 条码未找到
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""