根据广告位编码获取广告列表

接口描述：

  • 根据广告位置编码获取广告列表。

请求 URL：

  • http|https://host/api/v1/ads_position/method/get.ads.position.code/

请求方式：

  • GET
  • POST

是否授权：

  • 否

业务参数：

参数名 类型 是否必须 范围值 默认值 示例值 描述
code string 是 max:16 index_home 广告编码

响应参数：

参数名 类型 是否返回 示例值 描述
status integer 是 200 状态码
message string 是 success 消息信息
data object 否 [] 返回对象
data 类型 是否返回 示例值 描述
ads_position_id integer 是 4 广告位置编号
platform integer 是 0 广告位置平台(自定义)
name string 是 首页焦点轮播 广告位置名称
width integer 是 0 广告位置宽度
height integer 是 0 广告位置高度
content string 是 image.jpg 广告位置默认内容(图片,代码等)
color string 是 #ffffff 广告位置背景色
type integer 是 0 广告位置类型 0=图片 1=代码
display integer 是 0 广告位置展示方式 0=多个 1=单个 2=随机多个 3=随机单个
ads_items array 否 [] 广告列表数组
ads_items 类型 是否返回 示例值 描述
ads_id integer 是 1 广告编号
name string 是 五一促销 广告名称
url string 是 # 链接地址
target string 否 _self 打开方式
content string 否 //image.jpg 广告内容
color string 否 #ffffff 广告背景色

响应示例：

  1. {
  2.   "status": 200,
  3.   "message": "success",
  4.   "data": {
  5.     "ads_position_id": 1,
  6.     "platform": 0,
  7.     "name": "首页焦点轮播",
  8.     "width": 0,
  9.     "height": 0,
  10.     "content": "",
  11.     "color": "#ffffff",
  12.     "type": 0,
  13.     "display": 0,
  14.     "ads_items": [
  15.       {
  16.         "ads_id": 2,
  17.         "name": "端午促销",
  18.         "url": "#",
  19.         "target": "_self",
  20.         "content": "//image.jpg",
  21.         "color": "#ffffff"
  22.       },
  23.       {
  24.         "ads_id": 1,
  25.         "name": "五一促销",
  26.         "url": "#",
  27.         "target": "_self",
  28.         "content": "//image.jpg",
  29.         "color": "#ffffff"
  30.       }
  31.     ]
  32.   }
  33. }

备注:

前端调用广告必须使用广告编码或广告位编码获取。
广告列表与广告位置的区别在于，广告列表是单条广告，而广告位置是将广告列表进行了集合，如果列表为空则自身也是一条广告。