到家侧接口开发规范
API功能描述
商家商品状态检查接口
接口地址:https://openapi.jddj.com/djapi/search/getProductStatus
授权类型
是
应用场景
到家商品在前端展示的条件有四个:商家商品为上架状态、门店商品为可售状态、商品关联了门店店内分类、商品有库存(促销商品需看促销库存),其中任一条件不符则不展示。 调用该接口检查商品不展示的原因是什么: 1、如果productEntity(商品原始数据)中show为true(显示),esEntity(前端显示数据)中show为false(不显示),需再调用“商家商品状态同步接口”进行数据同步。 2、如果productEntity(商品原始数据)中show为false(不显示),则根据具体提示检查商品,并做出对应调整
系统级别输入参数
字段 | 类型 | 是否必须 | 描述 |
token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30 |
format | String | 是 | 暂时只支持json |
v | String | 是 | API协议版本,可选值:1.0 |
应用级别输入参数
字段 | 类型 | 是否必须 | 示例值 | 描述 |
返回结果
字段 | 类型 | 示例值 | 描述 |
code | String | 0 | 0表示成功,其他均为失败。 详见:到家平台状态码说明 |
msg | String | 操作成功 | 结果描述 |
+data | String | 返回对象,该属性值为字符串型JSON数据,请先按照字符串取值,再解析转换成JSON对象。 |
返回示例值
JSON 数据格式