22 Star 54 Fork 18

宇润 / ApiAgent

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 3.81 KB
一键复制 编辑 原始数据 按行查看 历史
宇润 提交于 2017-10-10 14:43 . 修复文档地址错误

ApiAgent

简介

API接口代理,支持跨域接口代理和接口合并请求功能。

在线文档

安装

当作类库使用

在您的composer.json中加入配置:

{
    "require": {
        "yurunsoft/api-agent": "1.0.*"
    }
}

作为项目运行

切换到ApiAgent目录下,执行下列命令:

composer install

跨域接口代理

通过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: {},
			// 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,其它名称不对传递来的参数做任何处理

PHP
1
https://gitee.com/yurunsoft/apiagent.git
git@gitee.com:yurunsoft/apiagent.git
yurunsoft
apiagent
ApiAgent
master

搜索帮助