查询单元详细数据
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
custnum | String | Y | 54321 | 用户id |
unitId | String | Y | 123456 | 单元id |
cityId | String | Y | 群 | 投放地区 |
appliCode | String | N | 342345 | 商家编码 |
userType | String | N | 4 | 用户类型 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | String | 0:成功,1:失败 | 状态 |
msg | String | 成功 | 状态说明 |
data | String | ||
promotionUnitId | String | 8880001000002140 | 推广单元ID |
promotionId | String | 50000150 | 推广计划ID |
userId | String | 428964304 | 查询用户ID |
isactive | String | 0 是,1 否 | 是否删除 |
brandId | String | 000150EOF | 品牌ID |
brandName | String | 巴宝莉修改test1001(Burberry1001) | 品牌名称 |
goodsCode | String | 12223 | 商品编码 |
generalCmmdtyCode | String | 344567894 | 商品通码 |
goodsUrl | String | default | 商品URL |
goodsName | String | 耐克 | 商品名称 |
goodsPrice | String | 100 | 商品价格 |
recommendPrice | String | 200 | 推荐基础出价 |
goodsSalePoint | String | 卖点 | 商品卖点 |
goodsSalePointExt | String | 便宜 | 处理后的商品卖点 |
goodsSalePointExtType | String | 1:卖点 2:评价 | 处理后的商品卖点类型 |
imgIndex | String | 0 | 图片位置索引LOCATION |
linkUrl | String | www.baidu.com | 商品着陆页URL |
name | String | 推广 | 推广单元名称 |
status | String | 0:暂停推广,1:正在推广 | 推广单元状态 |
updateTime | String | 1588158440000 | 更新时间 |
matchMode | String | ||
itemCode | String | "1001" | 商品编码 |
itemValue | String | “1” | 商品值 |
ocpc | String | ||
itemCode | String | "1005" | 商品编码 |
itemValue | String | “1” | 商品值 |
imgs | String | ||
illegalFlag | String | 1 | 非法标识 |
pictureLocation | String | 2 | 图片位置索引LOCATION |
pictureUrl | String | "http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h" | 图片地址 |
category | String | ||
categoryCode | String | "20006" | 商品类目编码 |
categoryName | String | "手机" | 商品类目名称 |
crowdInfo | String | ||
crowdId | String | "200402" | 人群标签ID |
crowdName | String | "223" | 人群标签名称 |
coverNum | String | "30000" | 覆盖人群数 |
selected | String | 0未选中 1选中 | 是否选中标志位 |
type | String | 0 搜索广告位,1 推荐广告位 | 类型 |
overPriceIndex | String | 10 | 10-1000溢价系数 |
flowPackList | String | ||
flowTypeExplain | String | "深度浏览,助力引流、拉新" | 流量包类型说明 |
flowTypeId | String | "1018" | 流量包类型ID |
flowTypeName | String | "购物前" | 流量包类型名称 |
premium | String | "0" | 溢价系数 |
goodsInfo | String | ||
goodsCode | String | "10160302529" | 商品编码 |
goodsName | String | "飞利浦" | 商品名称 |
goodsPrice | String | 1000 | 商品价格 |
goodsStatus | String | 1 | 商品状态 |
rankingsOrder | String | ||
itemCode | String | "1002" | 商品编码 |
itemValue | String | "top3" | 商品值 |
rankingsDiscount | String | ||
itemCode | String | "1003" | 商品编码 |
itemValue | String | "10" | 商品值 |
rankingsButton | String | ||
itemCode | String | "1004" | 商品编码 |
itemValue | String | "1" | 商品值 |
extField | String | ||
zncbPricePC | String | 100 | 智能词包pc出价 |
zncbPriceWAP | String | 100 | 智能词包无线出价 |
idea | String | ||
ideaId | String | 1 | 1 |
pictureId | String | 1 | 1 |
url | String | 1 | 1 |
title | String | 1 | 1 |
<sn_request> <sn_body> <queryEditunitindex> <appliCode>342345</appliCode> <custnum>54321</custnum> <unitId>123456</unitId> <cityId>群</cityId> <userType>4</userType> </queryEditunitindex> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "queryEditunitindex": { "appliCode": "342345", "custnum": "54321", "unitId": "123456", "cityId": "群", "userType": "4" } } } }
<sn_responseContent> <sn_body> <queryEditunitindex> <msg>成功</msg> <data> <goodsSalePointExtType>1:卖点 2:评价</goodsSalePointExtType> <isactive>0 是,1 否</isactive> <promotionId>50000150</promotionId> <promotionUnitId>8880001000002140</promotionUnitId> <imgIndex>0</imgIndex> <recommendPrice>200</recommendPrice> <linkUrl>www.baidu.com</linkUrl> <flowPackList> <flowTypeName>"购物前"</flowTypeName> <premium>"0"</premium> <flowTypeExplain>"深度浏览,助力引流、拉新"</flowTypeExplain> <flowTypeId>"1018"</flowTypeId> </flowPackList> <goodsSalePointExt>便宜</goodsSalePointExt> <extField> <idea> <pictureId>1</pictureId> <title>1</title> <url>1</url> <ideaId>1</ideaId> </idea> <zncbPriceWAP>100</zncbPriceWAP> <zncbPricePC>100</zncbPricePC> </extField> <goodsName>耐克</goodsName> <matchMode> <itemCode>"1001"</itemCode> <itemValue>“1”</itemValue> </matchMode> <imgs> <pictureLocation>2</pictureLocation> <pictureUrl>"http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h"</pictureUrl> <illegalFlag>1</illegalFlag> </imgs> <brandName>巴宝莉修改test1001(Burberry1001)</brandName> <rankingsButton> <itemCode>"1004"</itemCode> <itemValue>"1"</itemValue> </rankingsButton> <rankingsDiscount> <itemCode>"1003"</itemCode> <itemValue>"10"</itemValue> </rankingsDiscount> <updateTime>1588158440000</updateTime> <generalCmmdtyCode>344567894</generalCmmdtyCode> <userId>428964304</userId> <goodsSalePoint>卖点</goodsSalePoint> <rankingsOrder> <itemCode>"1002"</itemCode> <itemValue>"top3"</itemValue> </rankingsOrder> <goodsUrl>default</goodsUrl> <ocpc> <itemCode>"1005"</itemCode> <itemValue>“1”</itemValue> </ocpc> <brandId>000150EOF</brandId> <goodsPrice>100</goodsPrice> <name>推广</name> <goodsCode>12223</goodsCode> <category> <categoryCode>"20006"</categoryCode> <categoryName>"手机"</categoryName> </category> <crowdInfo> <coverNum>"30000"</coverNum> <type>0 搜索广告位,1 推荐广告位</type> <crowdId>"200402"</crowdId> <overPriceIndex>10</overPriceIndex> <selected>0未选中 1选中</selected> <crowdName>"223"</crowdName> </crowdInfo> <goodsInfo> <goodsStatus>1</goodsStatus> <goodsPrice>1000</goodsPrice> <goodsCode>"10160302529"</goodsCode> <goodsName>"飞利浦"</goodsName> </goodsInfo> <status>0:暂停推广,1:正在推广</status> </data> <status>0:成功,1:失败</status> </queryEditunitindex> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "queryEditunitindex": { "msg": "成功", "data": [ { "goodsSalePointExtType": "1:卖点 2:评价", "isactive": "0 是,1 否", "promotionId": "50000150", "promotionUnitId": "8880001000002140", "imgIndex": "0", "recommendPrice": "200", "linkUrl": "www.baidu.com", "flowPackList": [ { "flowTypeName": "\"购物前\"", "premium": "\"0\"", "flowTypeExplain": "\"深度浏览,助力引流、拉新\"", "flowTypeId": "\"1018\"" } ], "goodsSalePointExt": "便宜", "extField": [ { "idea": [ { "pictureId": "1", "title": "1", "url": "1", "ideaId": "1" } ], "zncbPriceWAP": "100", "zncbPricePC": "100" } ], "goodsName": "耐克", "matchMode": [ { "itemCode": "\"1001\"", "itemValue": "“1”" } ], "imgs": [ { "pictureLocation": "2", "pictureUrl": "\"http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h\"", "illegalFlag": "1" } ], "brandName": "巴宝莉修改test1001(Burberry1001)", "rankingsButton": [ { "itemCode": "\"1004\"", "itemValue": "\"1\"" } ], "rankingsDiscount": [ { "itemCode": "\"1003\"", "itemValue": "\"10\"" } ], "updateTime": "1588158440000", "generalCmmdtyCode": "344567894", "userId": "428964304", "goodsSalePoint": "卖点", "rankingsOrder": [ { "itemCode": "\"1002\"", "itemValue": "\"top3\"" } ], "goodsUrl": "default", "ocpc": [ { "itemCode": "\"1005\"", "itemValue": "“1”" } ], "brandId": "000150EOF", "goodsPrice": "100", "name": "推广", "goodsCode": "12223", "category": [ { "categoryCode": "\"20006\"", "categoryName": "\"手机\"" } ], "crowdInfo": [ { "coverNum": "\"30000\"", "type": "0 搜索广告位,1 推荐广告位", "crowdId": "\"200402\"", "overPriceIndex": "10", "selected": "0未选中 1选中", "crowdName": "\"223\"" } ], "goodsInfo": [ { "goodsStatus": "1", "goodsPrice": "1000", "goodsCode": "\"10160302529\"", "goodsName": "\"飞利浦\"" } ], "status": "0:暂停推广,1:正在推广" } ], "status": "0:成功,1:失败" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.advertise.queryeditunitindex.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.adss | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |