名人名言
阿凡达数据 官方文档
通过关键字查询名人名言
基本说明:
接口地址:http://api.avatardata.cn/MingRenMingYan/LookUp
返回格式:json/xml
请求方式:get/post
请求示例:http://api.avatardata.cn/MingRenMingYan/LookUp?key=[您申请的APPKEY]&keyword=天才&page=1&rows=5
请求参数说明:
名称 类型 必填 说明
key String 必填 应用APPKEY
keyword String 必填 查找关键字
page Int 选填 请求页数,默认page=1
rows Int 选填 返回记录条数,默认rows=20,最大50
dtype String 选填 返回结果格式:可选JSON/XML,默认为JSON
format Boolean 选填 当返回结果格式为JSON时,是否对其进行格式化,为了节省流量默认为false,测试时您可以传入true来熟悉返回内容
返回参数说明:
名称 类型 说明
参考JSON返回示例 - -
JSON返回示例:
{
	"error_code": 0,
	"reason": "Succes",
	"total": 42,
	"result": [{
			"famous_name": "华罗庚",
			"famous_saying": "科学上没有平坦的大道,真理长河中有无数礁石险滩。只有不畏攀登的采药者,只有不怕巨浪的弄潮儿,才能登上高峰采得仙草,深入水底觅得骊珠。"
		},
		{
			"famous_name": "华罗庚",
			"famous_saying": "在寻求真理的长征中,惟有学习,不断地学习,勤奋地学习,有创造性地学习,才能越重山,跨峻岭。"
		},
		{
			"famous_name": "华罗庚",
			"famous_saying": "钻研然而知不足,虚心是从知不足而来的。虚伪的谦虚,仅能博得庸俗的掌声,而不能求得真正的进步。"
		},
		{
			"famous_name": "华罗庚",
			"famous_saying": "天才是不足恃的,聪明是不可靠的,要想顺手拣来的伟大科学发明是不可想象的。"
		},
		{
			"famous_name": "华罗庚",
			"famous_saying": "独立思考能力,对于从事科学研究或其他任何工作,都是十分必要的。在历史上,任何科学上的重大发明创造,都是由于发明者充分发挥了这种独创精神。"
		}
	]
}
服务级错误码参照
错误码 说明
0 请求成功
1 参数错误
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10006 未知的请求源
10007 被禁止的IP
10008 被禁止的KEY
10009 当前IP请求超过限制
10010 请求超过次数限制,请购买套餐
10011 账户余额不足,请充值
10012 测试KEY超过请求限制
10013 请求错误,请重试
10014 接口维护
10015 接口停用
10016 当日调用次数到达上限,请明日重试或联系我们申请更多上限次数
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2019/3/15 17:50
 */
//----------------------------------
// 阿凡达数据 名人名言 调用类
//----------------------------------
class freeApi{
    private $apiUrl = 'http://api.avatardata.cn/MingRenMingYan/LookUp?key=[您申请的APPKEY]&keyword=天才&page=1&rows=5';
    /**
     * 将JSON内容转为数据,并返回
     * @param string $content [内容]
     * @return array
     */
    public function returnArray($content){
        return json_decode($content,true);
    }
    /**
     * 获取 名人名言 结果
     * @return array
     */
    public function getResult(){
        return $this->returnArray($this->freeApiCurl($this->apiUrl));
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function freeApiCurl($url,$params=false,$ispost=0){
        $ch = curl_init();
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_USERAGENT , 'free-api' );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            return false;
        }
        curl_close( $ch );
        return $response;
    }
}