Skip to content

banner.md

Latest commit

 

History

History
351 lines (286 loc) · 7.31 KB

banner.md

File metadata and controls

351 lines (286 loc) · 7.31 KB

获取【全部】轮播数据

通过该接口，你可以获取到全部的轮播数据

http://[域名]/api/banner

请求参数：[有]

参数名称 是否必选 参数类型 默认值 说明
limit 否 int 5 数据数量
page 否 int 1 分页请求
order 否 string create_time desc 排序方式
cache 否 bool true 是否获取缓存数据

** ajax **

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/banner',
  type:'GET',
  dataType:'JSON',
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

** axios **

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/banner').then((res) => {
  // 状态码 200 表示请求成功
  if(res.data.code == 200){
	console.log(res.data)
  }else{
	console.log(res)
  }
})
</script>

** php **

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/banner';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;
请求成功返回的数据结构 
{
    "code":200,
    "msg":"数据请求成功！",
    "data":{
        "page":1,
        "count":2,
        "data":[
            {
                "id":1,
                "title":"轮播一",
                "description":"轮播一描述",
                "url":"//inis.cn",
                "img":"https://api.inis.cn/storage/banner/1565407459914.jpg",
                "create_time":"2021-05-28 21:18:59",
                "update_time":"2021-05-28 21:43:29"
            },
            {
                "id":2,
                "title":"轮播二",
                "description":"轮播二描述",
                "url":"//api.inis.cn",
                "img":"https://api.inis.cn/storage/banner/1565407459914.jpg",
                "create_time":"2021-05-28 21:32:53",
                "update_time":"2021-05-28 21:43:26"
            }
        ]
    }
}

获取【一条】轮播数据

通过该接口，你可以获取指定轮播的详细数据

http://[域名]/api/banner

请求参数：[有]

参数名称 是否必选 参数类型 默认值 说明
id 否 int 无 轮播ID
cache 否 bool true 是否获取缓存数据

** ajax **

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/banner',
  type:'GET',
  dataType:'JSON',
  data: {"id":1},
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

** axios **

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/banner',{
    params:{ "id":1 }
  }).then(res=>{
    // 状态码 200 表示请求成功
    if(res.data.code == 200){
      console.log(res.data)
    }else{
      console.log(res)
    }
})
</script>

** php **

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/banner?id=1';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;
请求成功返回的数据结构 
{
    "code":200,
    "msg":"数据请求成功！",
    "data":{
        "id":1,
        "title":"轮播一",
        "description":"轮播一描述",
        "url":"//inis.cn",
        "img":"https://api.inis.cn/storage/banner/1565407459914.jpg",
        "expand":null,
        "opt":null,
        "create_time":"2021-05-28 21:18:59",
        "update_time":"2021-05-28 21:43:29"
    }
}

【SQL】接口

通过该接口，你可以自己编写SQL语法获取更多自定义的数据

http://[域名]/api/banner/sql

请求参数：[有]

参数名称 是否必选 参数类型 默认值 说明
limit 否 int 5 数据数量
page 否 int 1 分页请求
order 否 string create_time desc 排序方式
where 否 string 无 条件查询
whereOr 否 string 无 条件查询
cache 否 bool true 是否获取缓存数据

Details
字段说明
参数名称 语法 说明
where id=1;url=//inis.cn; 或 id=1 and url=//inis.cn 用 ; 号或 and 隔开多个参数
whereOr title,like,%轮播一%;url,=,//inis.cn; 用 ; 号隔开多个查询条件，每个查询条件有三个参数，用 , 号隔开

** ajax **

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/banner/sql',
  type:'GET',
  dataType:'JSON',
  data:{
    "limit":3,
    "where":"id=1;utl=//inis.cn;"
  },
  success:function (res) {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

** axios **

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/banner/sql',{
    params:{
      "order"  : "id acs",
      "whereOr": "title,like,%轮播一%",    // 可以实现模糊搜索
    }
  }).then(res=>{
    // 状态码 200 表示请求成功
    if(res.data.code == 200){
      console.log(res.data)
    }else{
      console.log(res)
    }
})
</script>

** php **

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/banner/sql?where=id=1;url=//inis.cn;';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;
请求成功返回的数据结构 
{
    "code":200,
    "msg":"ok",
    "data":{
        "page":1,
        "count":1,
        "data":[
            {
                "id":1,
                "title":"轮播一",
                "description":"轮播一描述",
                "url":"//inis.cn",
                "img":"https://api.inis.cn/storage/banner/1565407459914.jpg",
                "expand":null,
                "opt":null,
                "create_time":"2021-05-28 21:18:59",
                "update_time":"2021-05-28 21:43:29"
            }
        ]
    }
}