批量外部资源
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
mediaInputs | String | N | ||
storeTypes | String | Y | 19 | 新潮传媒 |
mediaId | String | Y | 98N7 | 媒体点位编码:渠道管理媒体的唯一标识 |
operate | String | Y | 0 | 操作 :新增/编辑-0;删除-1 |
shopName | String | Y | 紫金嘉悦 | 网点名称:广告位所在的POI点信息,社区名称、楼宇名称等 |
provinceName | String | Y | 江苏省 | 省份名称(需填写省) |
cityName | String | Y | 南京市 | 市名称(需填写市) |
areaName | String | Y | 玄武区 | 区名称(需填写区) |
address | String | Y | 玄武大道1号 | 详细地址,描述至街道门牌号 |
longitude | String | Y | 119.292912 | 经度(百度坐标系) |
latitude | String | Y | 26.068504 | 纬度(百度坐标系) |
senceId | String | Y | 1001 | 网点所属场景编码,详情见码表值 |
unitNumber | String | N | 3 | 单元数量(个) |
buildingNumber | String | N | 50 | 楼栋数量(栋) |
mediaNumber | String | N | 50 | 网点广告位数量(个) |
coverNumber | String | N | 10000 | 网点覆盖人数(人) |
passengerNumber | String | N | 1000000 | 客流量(人/天) |
floorSpace | String | N | 40.15 | 占地面积,单位平方米 |
propertyCosts | String | N | 100.98 | 物业费,单位每平方米 |
businessHours | String | N | 12 | 营业时长,单位小时 |
parkingSpace | String | N | 110 | 停车场车位数(个) |
shopNumber | String | N | 5 | 店铺数量(个) |
shopProperty | String | N | 性质属性 | 小区或商场等场景的性质属性,如高档型、经济型、高科技型小区等 |
remarks | String | N | 这是电子屏 | 备注,限制200字符内 |
categoryCode | String | Y | AdPosition_SmallShop_Type_video2 | 媒体点位类型,请联系星云屏运营人员提供类型编码值 |
length | String | N | 10.11 | 长度 单位cm |
height | String | N | 10.11 | 高度 单位cm |
width | String | N | 10.11 | 宽度 单位cm |
resolution | String | N | 1920X1080 | 分辨率:接入设备屏幕的分辨率,分辨率和长宽高中,必须填其中之一,具体见码表值 |
showPosition | String | Y | 1 | 点位所在位置:室内-1;室外-0 |
floor | String | N | 3F | 3楼 |
detailedLocation | String | Y | 紫金嘉悦东大门门口 | 详细安装位置 |
price | String | Y | 150.66 | CPT刊例价(元):最小售卖周期对应的刊例价 |
duration | String | Y | day | 点位最小售卖周期:天-day,周-week,月-month,年-year |
mediaPicture | String | Y | http://www.suning.com/1,jpg | 点位图片外网url:单张不超过1M,图片大小建议为200*135 |
isVertical | String | N | 1 | 屏幕方向:横屏-0;竖屏-1 |
screenPosition | String | N | 1|2|3|4|5 | 分屏方式:1-全屏、2-左右、3-左中右、4-上下、5-上中下 |
contractNumber | String | Y | SN12239991 | 价格合同编码:渠道对接内部价,具体和星云屏商务人员联系 |
isVoice | String | Y | 1 | 广告位是否有声音:无-0;有-1 |
materialTime | String | N | 15 | 素材时长(s):5;15;30;60 |
prohibitedContent | String | N | 医药类 | 禁止播放内容,详情见码表值 |
materialSize | String | N | 100*100*100 | 广告位素材尺寸单位cm |
salesType | String | Y | 1 | 售卖方式:CPT-1;CPM-2 |
cptMediaMode | String | N | 1 | 广告播出方式:15秒轮播-1;触屏后跳出-2;开机广告-3;购物支付-4 |
mediaPlayDuration | String | N | 5|15|30|60 | 素材时长(s):5;15;30;60 |
cptMaxPlayTimes | String | N | 100 | CPT单日最大播放次数(次) |
cptPublishDates | String | N | 1,2,3,4,5 | 周一到周五播放,CPT必填 |
cptPrice | String | N | 100.01 | CPT单日价格(元)CPT必填 |
cptSalesTimes | String | N | 300 | CPT单日可售次数(次)CPT必填 |
cptPlayTimes | String | N | 200 | CPT单日播放次数 CPT必填 |
cpmPrice | String | N | 100.01 | CPM 价格(元)CPM必填 |
unitCount | String | Y | 10 | 多屏售卖次数,不涉及填1 |
storeType | String | Y | 19 | 外部媒体渠道编码:请联系星云屏运营人员提供 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | String | ||
resultCode | String | T | 成功 |
resultMsg | String | 省份不存在 | 错误提示信息 |
successList | String | [1,2,3] | 成功的点位ID |
failedList | String | ||
mediaId | String | 1 | 错误的点位ID |
errorTips | String | 分类不存在 | 错误提示 |
<sn_request> <sn_body> <addChannel> <storeType>19</storeType> <mediaInputs> <cptSalesTimes>300</cptSalesTimes> <unitNumber>3</unitNumber> <mediaId>98N7</mediaId> <showPosition>1</showPosition> <resolution>1920X1080</resolution> <coverNumber>10000</coverNumber> <cptPublishDates>1,2,3,4,5</cptPublishDates> <mediaPlayDuration>5|15|30|60</mediaPlayDuration> <areaName>玄武区</areaName> <price>150.66</price> <buildingNumber>50</buildingNumber> <cptMaxPlayTimes>100</cptMaxPlayTimes> <passengerNumber>1000000</passengerNumber> <height>10.11</height> <longitude>119.292912</longitude> <mediaNumber>50</mediaNumber> <unitCount>10</unitCount> <contractNumber>SN12239991</contractNumber> <materialSize>100*100*100</materialSize> <parkingSpace>110</parkingSpace> <isVoice>1</isVoice> <operate>0</operate> <isVertical>1</isVertical> <shopNumber>5</shopNumber> <provinceName>江苏省</provinceName> <floorSpace>40.15</floorSpace> <cptPrice>100.01</cptPrice> <mediaPicture>http://www.suning.com/1,jpg</mediaPicture> <propertyCosts>100.98</propertyCosts> <storeTypes>19</storeTypes> <screenPosition>1|2|3|4|5</screenPosition> <latitude>26.068504</latitude> <shopName>紫金嘉悦</shopName> <cptMediaMode>1</cptMediaMode> <shopProperty>性质属性</shopProperty> <duration>day</duration> <cityName>南京市</cityName> <floor>3F</floor> <prohibitedContent>医药类</prohibitedContent> <salesType>1</salesType> <cpmPrice>100.01</cpmPrice> <detailedLocation>紫金嘉悦东大门门口</detailedLocation> <address>玄武大道1号</address> <businessHours>12</businessHours> <length>10.11</length> <categoryCode>AdPosition_SmallShop_Type_video2</categoryCode> <materialTime>15</materialTime> <width>10.11</width> <cptPlayTimes>200</cptPlayTimes> <senceId>1001</senceId> <remarks>这是电子屏</remarks> </mediaInputs> </addChannel> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "addChannel": { "storeType": "19", "mediaInputs": [ { "cptSalesTimes": "300", "unitNumber": "3", "mediaId": "98N7", "showPosition": "1", "resolution": "1920X1080", "coverNumber": "10000", "cptPublishDates": "1,2,3,4,5", "mediaPlayDuration": "5|15|30|60", "areaName": "玄武区", "price": "150.66", "buildingNumber": "50", "cptMaxPlayTimes": "100", "passengerNumber": "1000000", "height": "10.11", "longitude": "119.292912", "mediaNumber": "50", "unitCount": "10", "contractNumber": "SN12239991", "materialSize": "100*100*100", "parkingSpace": "110", "isVoice": "1", "operate": "0", "isVertical": "1", "shopNumber": "5", "provinceName": "江苏省", "floorSpace": "40.15", "cptPrice": "100.01", "mediaPicture": "http://www.suning.com/1,jpg", "propertyCosts": "100.98", "storeTypes": "19", "screenPosition": "1|2|3|4|5", "latitude": "26.068504", "shopName": "紫金嘉悦", "cptMediaMode": "1", "shopProperty": "性质属性", "duration": "day", "cityName": "南京市", "floor": "3F", "prohibitedContent": "医药类", "salesType": "1", "cpmPrice": "100.01", "detailedLocation": "紫金嘉悦东大门门口", "address": "玄武大道1号", "businessHours": "12", "length": "10.11", "categoryCode": "AdPosition_SmallShop_Type_video2", "materialTime": "15", "width": "10.11", "cptPlayTimes": "200", "senceId": "1001", "remarks": "这是电子屏" } ] } } } }
<sn_responseContent> <sn_body> <addChannel> <result> <successList>[1,2,3]</successList> <failedList> <errorTips>分类不存在</errorTips> <mediaId>1</mediaId> </failedList> <resultCode>T</resultCode> <resultMsg>省份不存在</resultMsg> </result> </addChannel> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "addChannel": { "result": [ { "successList": "[1,2,3]", "failedList": [ { "errorTips": "分类不存在", "mediaId": "1" } ], "resultCode": "T", "resultMsg": "省份不存在" } ] } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.advertise.addchannel.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.advertise.addchannel.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.advertise.addchannel.length-overlong:* | 参数的值超过规定长度 | 请检查此参数的值,*号表示参数字段名 |
biz.advertise.addchannel.enumeration-error:* | 参数的可选值错误 | 请检查此参数的值,*号表示参数字段名 |
isp.sys.service.unavailable.dtb | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |