YurunDoc 接口合并请求
2018-10-12 13:20 更新
通过batch.php
文件访问,请求规则是POST提交json格式内容。
配置文件:Config/batch.php
jQuery调用样例代码:
// 设置跨域传递cookie,如果不需要可以去除
$.ajaxSetup({
xhrFields: {
withCredentials: true
},
});
$.ajax({
// 在线演示地址,随时可能崩掉,正式使用时请改成你自己的
url: 'http://apiagent.toolapi.net/batch.php',
method: 'post',
data: JSON.stringify({
/*aip: {
url: 'ip', // 在apis中预定义的接口,传别名即可
getData: {ip: '218.4.255.255'},
},*/
aip: {
url: 'http://int.dpool.sina.com.cn/iplookup/iplookup.php?format=json',
getData: {ip: '218.4.255.255'}, // 这里的IP改变也会改变下面baike的结果哦
},
// weather2是错误的结果,会中断
/*weather2: {
url: 'http://www.weather.com.cn/data/sk/1010101001.html',
condition: { // 返回结果.weatherinfo不为null
value: '{$weather2.weatherinfo}',
regular: 'is not null',
},
},*/
baike: {
url: 'http://baike.baidu.com/api/openapi/BaikeLemmaCardApi?scope=103&format=json&appid=379020&bk_length=600',
// get参数
getData: {
bk_key: '{$aip.city}', // api接口中返回的数据.city
},
// post参数
postData: {},
// GET请求数据类型
getDataType: 'form',
// POST请求数据类型
bodyDataType: 'form',
// 自定义header,不定义则使用默认
header: {
'test': 'aaa',
},
// 验证返回结果是否正确,不正确会中断请求并返回
condition: {
value: '{$baike.errno}',
regular: 'is not null',
},
},
}),
success: function(data) {
console.debug(data);
}
});
接口合并请求返回结构
{
// 是否成功
"success": true,
// 错误信息
"message": "",
// 返回正文数据
"data": {
"test": ""
},
// 返回结果
"result": {
// 键名=>返回头数据
"test": {
// 状态码
"status_code": 208,
// 返回头
"header": {
"Server": "squid/3.5.20",
"Date": "Mon, 09 Oct 2017 07:38:54 GMT",
"Content-Type": "application/octet-stream",
"Content-Length": "0",
"Connection": "keep-alive"
},
// 请求耗时
"time": 0.047
}
}
}
预定义验证规则
代码 | 含义 |
---|---|
is null | null === $value |
is not null | null !== $value |
empty array | 0 === count($value[0]) |
not empty array | count($value[0]) > 0 |
true | true === $value |
false | false === $value |
除了预定义规则,你还可以编写正则来验证。如:\d+
dataType数据类型
名称 | 含义 |
---|---|
form | 表单参数格式(如:a=1&b=2),默认 |
json | 转为json格式提交 |
不传默认为form,其它名称不对传递来的参数做任何处理
以上内容是否对您有帮助:
更多建议: