天行数据TianAPI数据类免费接口

以下是天行数据部分数据类API接口，可用于微信第三方/网站/APP/小程序开发等。

**

请求方法

**
HTTP/HTTPS GET

**

使用帮助

**
默认返回1条数据，非必填参数请按需传递。长网址转换无需KEY参数。

**

接口表

**
数据名称 请求地址 备注说明
菜谱查询 http://api.tianapi.com/txapi/caipu/ 菜谱查询，生活类厨房类应用必备API
周公解梦 http://api.tianapi.com/txapi/dream/ 梦也许预示着某种含义，娱乐类应用必备
雷人笑话 http://api.tianapi.com/txapi/joke/ 笑一笑十年笑
名言警句 http://api.tianapi.com/txapi/dictum/ 随机跳出一句格言，是不是很有格调？
生日预测 http://api.tianapi.com/txapi/dob/ 也许每个人的性格和生日有某种关联
脑筋急转弯 http://api.tianapi.com/txapi/naowan/ 脑机急转弯，高IQ必备
历史的今天 http://api.tianapi.com/txapi/lishi/ 历史的今天，以史为鉴
成语典故 http://api.tianapi.com/txapi/chengyu/ 包括成语典故、来源、范例、拼音等，支持模糊搜索。
一战到底 http://api.tianapi.com/txapi/wenda/ 一站到底，竞答类应用必备
地名谜语 http://api.tianapi.com/txapi/cityriddle/ 地名谜语，根据提示猜城市名称
网络热词 http://api.tianapi.com/txapi/hotword/ 网络上最近又有那些流行语？
股市术语 http://api.tianapi.com/txapi/shares/ 股海无涯，回头是岸
网址转换 http://api.tianapi.com/txapi/turl/ 将复杂的长网址为短连接
网络取名 http://api.tianapi.com/txapi/cname/ 歇后语，娱乐类应用必备
绕口令 http://api.tianapi.com/txapi/rkl/ 绕口令，初入江湖都会化肥会挥发
神回复 http://api.tianapi.com/txapi/godreply/ 神回复，不经意的一句话惊天泣地、一语惊人
ip地址查询 http://api.tianapi.com/txapi/ipquery/ 最新最全的IP地址库查询接口，返回包含经纬度等。
手机归属地 http://api.tianapi.com/txapi/mobilelocal 查询手机号码所属地区、运营商、邮政编码等
中国黄历 http://api.tianapi.com/txapi/lunar/ 中国老黄历API，近30个字段的返回数据
**

调用参数总表

**
请求参数 类型 必填 参数位置 描述 备注说明
key string 是 urlParam API密钥（请在个人中心获取） 用户自己的key，长网址转换API可省略
num int 否 urlParam 指定返回数量，最大50 默认1(≤50，null=1)
m int 是 urlParam 月 1，生日预测专用参数
d int 是 urlParam 日 2，生日预测专用参数
date time 否 urlParam 指定日期，缺省则为当前日期 0101，历史的今天接口参数
word string 否 urlParam 检索关键词 笑话、脑筋急转弯、歇后语等无此参数
page int 否 urlParam 翻页，每页输出数量跟随num参数 笑话、脑筋急转弯、歇后语等无此参数
mode int 否 urlParam 若mode=1则为模糊搜索模式 成语典故专用参数
ip string 是 urlParam 需要查询的IP地址 IP查询接口专用参数
phone string 是 urlParam 需要查询的手机号码 手机归属地查询接口专用参数
date time 是 urlParam 公历查询请直接传时间戳 中国老黄历参数，农历请传日期如2019-1-14（日期前不得有0）
友情提示
点击左侧可展开分别查看每个接口的调用方法

全局返回码
code=>200为正常返回数据，其他状态码可参考下表。

错误代码 错误消息 解释帮助
100-140 系统级错误 1开头返回码是系统级错误
200 success 调用成功完整返回数据
230 key错误或为空 请检查apikey是否填写错误或未正确传递
240 缺少key参数 请检查是否传递了key参数或赋值
250 未检索到相关信息 在数据库或缓存中没有检索到查询的信息
260 关键词不得为空 word参数不要传递空值
270 天行币余额不足 账号天行币余额不足，请在个人中心查看
280 缺少有效数据 部分接口需要传递数据，请按接口说明来
290 返回的内容为空 一般情况下，指没有查询到相关信息
300 缺少必要的参数 缺少必填的参数，请根据接口文档检查
310 API调用频率超限 API超出了频率限制，到期后即可释放恢复
320 API没有调用权限 该API只有特定用户才可以调用
330 Referer调用来源受限 设置了Referer来源白名单
340 IP请求来源受限 设置了IP白名单
400 超过资源字节限制 超过了1024个字节限制
410 语音识别或合成失败 机器人语音识别或合成失败
友情提示
100-140是系统级错误，出现的概率极低。具体情况可参照返回的msg状态消息。

**

代码参考

**
PHP获取数据

<?php header("Content-Type: text/html; charset=utf-8"); $num = 20; //返回数量 $url = 'http://api.tianapi.com/wxnew/?key=您的APIKEY&num='.$num; //API接口 $ch = curl_init(); $timeout = 5; curl_setopt ($ch, CURLOPT_URL, $url); curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout); $file_contents = curl_exec($ch); curl_close($ch); // var_dump(json_decode($file_contents )); $json = json_decode($file_contents,true); if($json['code'] == 200){ $txapi=$json['newslist']; for ($i = 0; $i < $num; $i++){ // echo var_dump($de_json); $title = $txapi[$i]['title']; //文章标题 $desc = $txapi[$i]['description']; //文章描述 $pic = $txapi[$i]['picUrl']; //封面图片 $url = $txapi[$i]['url']; //文章链接 echo $title."
".$desc."
".$pic."
".$url."
"; } }else{ echo "返回错误，状态消息：".$json['msg']; } python获取数据 # -*- coding: utf-8 -*- import sys, urllib, urllib2, json url = 'http://api.tianapi.com/wxnew/?key=您的key&num=10' req = urllib2.Request(url) resp = urllib2.urlopen(req) content = resp.read() if(content): print(content) JAVA获取数据 String httpUrl = "http://api.tianapi.com/wxnew/?key=您的key&num&rand"; String jsonResult = request(httpUrl); System.out.println(jsonResult); /** * @param urlAll * :请求接口 * @param httpArg * :参数 * @return 返回结果 */ public static String request(String httpUrl, String httpArg) { BufferedReader reader = null; String result = null; StringBuffer sbf = new StringBuffer(); httpUrl = httpUrl + "?" + httpArg; try { URL url = new URL(httpUrl); HttpURLConnection connection = (HttpURLConnection) url .openConnection(); connection.setRequestMethod("GET"); InputStream is = connection.getInputStream(); reader = new BufferedReader(new InputStreamReader(is, "UTF-8")); String strRead = null; while ((strRead = reader.readLine()) != null) { sbf.append(strRead); sbf.append("\r\n"); } reader.close(); result = sbf.toString(); } catch (Exception e) { e.printStackTrace(); } return result; } AJAX获取数据 $(document).ready(function(){ $('#button').click(function(){ $.ajax({ type:"GET", url:"http://api.tianapi.com/wxnew/?key=您的key&num=10", dataType:"json", success:function(data){ var txapi="

• "; for(var i=0; i<10; i++) { txapi+="
• "+data["newslist"][i]["title"]+"
• "; txapi+="
• "+data["newslist"][i]["description"]+"
• "; txapi+="
• "+data["newslist"][i]["picUrl"]+"
• "; txapi+="
• "+data["newslist"][i]["url"]+"
• "; } txapi+="

"; $('#result').append(txapi); } }); return false; }); }); 天行数据官网地址：https://www.tianapi.com