足球新闻API接口 - 天行数据TianAPI

足球新闻

国足新闻动态实时更新免费接口正常调用

图文类接口功能扩展，混合输出全频道新闻数据使用综合新闻接口、按格式抽取网页中的图片使用抽取网页图片接口、获取新闻或网页文章全文内容使用网页文章全文接口、获取所有新闻频道栏目ID使用频道列表接口、按新闻频道分类输出使用分类新闻接口、任意图文列表类资讯输出请使用网页转API功能。

▼ 接口信息

接口地址：http://api.tianapi.com/football/index

请求示例：http://api.tianapi.com/football/index?key=APIKEY&num=10

支持协议：HTTP/HTTPS

请求方式：GET/POST

返回格式：UTF8 JSON

▼ 请求参数

post请求时，enctype应为application/x-www-form-urlencoded

请求参数中有url或特殊字符时，应该对值urlencode编码下

名称	类型	必填	示例值/默认值	说明
key	string	是	您自己的APIKEY（注册账号后获得）	API密钥
num	int	是	10	返回数量1-50，默认10
page	int	否	1	翻页
rand	int	否	1	随机获取
word	string	否	天行数据	检索关键词

▼ 返回示例

返回示例作为参考，建议以实际测试结果为准

▼ 返回参数

名称	类型	示例值	说明
id	string	62ac899e8fcf654a74479b4239b4651f	新闻唯一ID
ctime	Date	2015-07-17	发布时间
title	string	文章的标题	文章标题
description	string	文章的描述	文章描述
source	string	文章来源	文章来源
picUrl	string	https://www.tianapi.com/static/img/logo.png	封面图片
url	string	https://www.tianapi.com/article/154	文章地址

▼ 接口价格

用户等级	免费接口数	每日赠送次数	会员价格	说明
免费会员	15个	100次	免费	每个免费接口每天赠送100次
高级会员	15个	1万次	20元/月、120元/年	每个免费接口每天赠送1W次
黄金会员	不限	50万次	65元/月、390元/年	每个免费接口每天赠送50W次
提示：系统优先使用赠送额度，超出后每次调用消耗1颗天豆（0.0001元），如项目有更高需求请点此升级会员等级。

▼ 错误状态码

错误消息可能会有所调整，请根据错误代码进行流程判断

错误代码	错误消息	解释帮助
100	内部服务器错误	出现此错误码请及时反馈或等待修复
110	接口暂时维护中	接口暂时关闭维护中，请注意相关公告
120	IP请求来源受限	设置了IP白名单，来源IP不在白名单内
130	分钟请求频率超限	API超出了分钟调用最大频率被暂时限制
140	API没有调用权限	请检查接口是否被自行停用或被官方禁用
150	接口可用次数不足	接口可用次数不足，请在接口列表查看
160	账号未申请该接口	请先在对应的接口文档页面申请接口，点此查看帮助
170	Referer请求来源受限	设置了Referer白名单，来源Referer不在白名单内
230	key错误或为空	请检查apikey是否填写错误，点此查看帮助
240	缺少key参数	请检查是否传递了key参数，如变量请检查是否赋值
250	数据返回为空	数据查询或转换失败，请确保输入值正确或重试
260	参数值不得为空	请检查查询参数是否传递了空值
270	缺少有效数据	接口需要传递数据，请参考接口文档的说明
280	缺少必要的参数	缺少必填的参数，请根据接口文档检查
290	超过最大输入字节限制	超出最大字符，请查看对应的接口文档说明
1开头的是系统级错误，2开头的是用户级错误，其中200代码表示请求成功处理。

▼ 参考代码

其他可直接下载使用的部分开源项目推荐。

此处的参考代码都是get方式请求，post请求请参考此项目。

此处代码并非完整项目，仅供参考，实际使用请根据本地开发环境修改。