开始
AYLIEN新闻API是最强大的来源、搜索和联合丰富的新闻内容的方式。在这里，您将找到关于使用News API所需了解的一切。
调用API
GET或POST
除了使用sdk，您可以通过发送HTTP直接调用API帖子或得到请求https://api.www.daredevilro.net/news/，后面跟着端点名称。所有端点都支持得到方法，而只有/保险而且/ related_stories端点支持得到而且帖子方法。如果你处理的是长文本，请考虑使用帖子．
授权
通过在调用头中添加App ID和App Key，对API的请求进行授权。当您报名．
X-AYLIEN-NewsAPI-Application-ID必须设置为您的应用程序ID。X-AYLIEN-NewsAPI-Application-Key必须设置为您的应用程序密钥。
错误码与响应
| 代码 | 文本 | 描述 |
|---|---|---|
| 200 | 好吧 | 成功! |
| 400 | 坏的请求 | 由于明显的客户端错误，服务器不能或将不处理请求。 |
| 401 | 未经授权的 | 身份验证凭据缺失或不正确。 |
| 403 | 被禁止的 | 您的计划无法访问您请求的特性，这意味着您的请求无法得到满足。在响应消息中提供了关于缺失特性的更多细节。 |
| 404 | 没有找到 | 请求的URI无效或请求的资源(如故事)不存在。 |
| 405 | 方法不允许 | 请求方法不支持被请求的资源。 |
| 414 | URI的时间太长 | 提供的URI太长，服务器无法处理。最大请求URI大小为2kb。 |
| 422 | Unprocessable实体 | 请求无效或无法以其他方式处理。 |
| 429 | 太多的请求 | 超过使用限制。 |
| 500 | 内部服务器错误 | 发生了一个意外的错误，我们已经通知了工程师。如果你继续有问题，联系我support@www.daredevilro.net． |
| 503 | 服务不可用 | 服务器目前不可用(因为它超载或停机维护)。 |
| 504 | 网关超时 | 服务器无法及时得到响应，可能是因为网页被屏蔽或在付费墙后面。 |
速度限制
API的速率限制主要基于每个应用程序——或者更准确地说，基于您控制的每个应用程序ID。
支安打
每个端点都受每分钟60次点击和每秒3次点击的速率限制。
故事卷
当应用程序超过给定API端点的速率限制时，AYLIEN News API将返回一个HTTP 429“请求太多”响应代码。
检查你剩下的故事卷
有三个响应头，您可以使用检查您的配额配额，点击数量剩余的配额，以及时间和日期您的配额将被重置:
X-RateLimit-Limit:当前时间段内允许的请求数X-RateLimit-Remaining:当前时间段内的剩余请求数X-RateLimit-Reset:在UTC重置速率限制之前的剩余窗口时代秒
许可的内容
访问我们授权内容的客户将能够从我们的授权来源检索故事。的license_type字段(故事端点响应中的一个字段)表示一篇文章是来自授权来源，还是来自网络来源。
示例license_type标志输出
"license_type": 0 #表示新闻来自基于web的信息源组。"license_type": 1 #表示新闻来自授权信息源组URL编码
记得url你的查询。下面的例子展示了如何正确编码查询。
| 查询 | url编码查询 |
|---|---|
| published_at.start = NOW-30DAYS&categories.id [] = IAB1-5&entities.body.links.dbpedia [] = http://dbpedia.org/resource/Star_Wars&categories.taxonomy=iab-qag | published_at.start = NOW-30DAYS&categories.id % 5 b % 5 d = IAB1-5&entities.body.links.dbpedia % 5 b % 3 5 d = http % % 2 f % 2 fdbpedia.org % 2 fresource % 2 fstar_wars&categories.taxonomy = iab-qag |
| 标题=特朗普或Sanders&entities.title.text[] =选举 | 标题=特朗普+或+ Sanders&entities.title.text % 5 b % 5 d =选举 |
| 标题= Ireland&published_at.end = NOW-2MONTHS /天 | title = Ireland&published_at.end fday = NOW-2MONTHS % 2 |
语言支持
我们的API支持多种(人类)语言，可以使用语言[]参数。
英语(在） |
德国(德） |
法语(fr） |
意大利(它） |
西班牙语(西文） |
葡萄牙语(pt） |
俄罗斯(俄文） |
荷兰(问） |
阿拉伯语(基于“增大化现实”技术） |
土耳其(tr） |
中文(繁体)(zh-tw） |
中文(简体)(应用） |
瑞典(sv） |
丹麦(达） |
芬兰(fi） |
波斯语(足总） |
我们的一些特征是在用原语言分析文本后添加到故事对象中，而其他特征是在文本翻译成英语后添加的。下表列出了用于分析每个特性的语言。
| 功能 | 原始文本分析 | 翻译文本分析 |
|---|---|---|
| 集群 | 在 |
所有其他语言 |
| 主题分类 | 在 |
所有其他语言 |
| 实体 | 在 |
所有其他语言 |
| 情绪(身体) | 在，西文，德 |
所有其他语言 |
| 提取关键字 | 在，西文，德，它，fr，pt |
所有其他语言 |
| 标签 | 在，西文，德，它，fr，pt |
所有其他语言 |
| 单词、字符和段落都很重要 | 在，西文，德，它，fr，pt |
所有其他语言 |
使用Postman测试News API
如果您正在寻找一种快速而直接的方法来测试News API并熟悉其各种端点和参数，那么您可能需要考虑我们的Postman集成(除了我们的交互式文档和我们的查询构建器）.
邮递员是一套用于测试、构建和记录api的工具套件，可以从在这里．
一旦你下载并安装了Postman，按照下面的步骤来安装和运行News API:
步骤1
在开始之前，确保你已经创建了一个News API帐户，并能够访问你的App ID和Key。点击在这里创建一个免费帐户。
步骤2
打开邮差，然后按一下进口左上角按钮:
步骤3
在Import对话框中，单击从链接进口按钮，并将以下URL粘贴到输入框中，然后单击进口．
https://docs.www.daredevilro.net/yaml_files/api.yaml步骤4
您需要从导入的输入yaml文件生成Postman集合。为此，为您的集合命名并单击生成集合．
导入模式之后，您应该能够在左边看到一个新的集合。
添加API凭证
一旦你的模式被导入，第一步就是添加你的App ID和Key。点击列表的故事端点在集合中，然后单击头．这将显示两个字段(X-AYLIEN-NewsAPI-Application-ID而且X-AYLIEN-NewsAPI-Application-Key)，你可以在那里添加你的证书。
步骤5
添加凭据后，需要替换占位符{{baseUrl}}文本与https://api.www.daredevilro.net/news．
现在可以通过单击来配置请求并设置其参数参数个数．这样做可以显示任何端点的所有可用参数，允许您查看或编辑任何参数:
完成后，点击发送提交请求并在下面的方框中检索JSON格式的结果。