简介
ApiAgent是由宇润使用PHP开发且开源的一个API接口代理，支持跨域接口代理和接口合并请求功能。
作为跨域接口代理时，除了将要请求的url放到参数内以外，其它header以及post数据完全不需要有任何改动。
github：https://github.com/Yurunsoft/ApiAgent
码云：http://git.oschina.net/yurunsoft/apiagent
程序员的职业生涯、生活、技术问题都欢迎加Q群讨论：74401592
用途
在海外服务器上部署，作为海外平台（facebook、twitter等）接口调用的中转。
已有接口不支持跨域时，通过代理实现跨域。
访问页面需要多次接口请求，使用接口合并功能只需一次，减少用户等待时间，节省移动端流量。
composer安装命令
composer install
中国用户如果使用composer很卡，请查看：https://pkg.phpcomposer.com/
跨域接口代理
通过index.php文件访问，默认参数为url，注意需要urlencode编码。
例子：http://apiagent.toolapi.net/?url=http://www.baidu.com
（上面是在线演示地址，随时可能崩掉，正式使用时请改成你自己的！）
该接口原样返回状态码、返回头（包括cookie）、返回内容。
配置文件：Config/cross.php
接口合并请求
通过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: {},
// 数据类型
dataType: 'form',
condition: {
value: '{$baike.errno}',
regular: 'is not null',
},
},
}),
success: function(data) {
console.debug(data);
}});预定义验证规则
| 代码 | 含义 |
|---|---|
| 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格式提交 |