开始
AYLIEN文本分析API是一个自然语言处理和机器学习API包，用于从文本内容中分析和提取各种信息。
在这里，您将找到关于使用文本分析API所需知道的一切。如果您是一个新用户，您将需要获取一个API Key在这里．
API密钥和凭证
为了使用文本分析API，您必须在我们的开发人员门户，在那里你可以找到一个API ID而且关键：
使用API
一旦你有了你的API密钥和ID，你可以用两种方式使用文本分析API:
- 通过发送HTTP
帖子或得到请求https://api.www.daredevilro.net/api/v1后跟端点名称，例如，对于Concept Extraction调用，完整的URL将是https://api.www.daredevilro.net/api/v1/concepts． - 通过使用我们的sdk．如果您正在使用SDK，请跳过以下部分，直接跳到端点举例说明如何使用任何sdk来利用API。
授权
对API的请求必须通过添加以下头进行授权:
X-AYLIEN-TextAPI-Application-Key必须设置为您的应用程序密钥。X-AYLIEN-TextAPI-Application-ID必须设置为您的应用程序ID。
GET或POST
大多数端点都支持这两种方式得到而且帖子方法。如果你处理的是较长的文件，请考虑使用帖子．
最大输入大小
请求URI的最大大小是8kb, body不能超过6mb。
JSON或XML
该API默认返回JSON结果。您可以为所有端点请求JSON或XML格式的结果。集接受头来text / xml或application / json更改结果的格式。
速度限制
根据你的订阅计划，您的申请受到每日和每分钟的限制。有三个响应头，您可以使用来检查您的配额配额，剩余的电话数量，您的配额将被重置的时间和日期:
X-RateLimit-Limit:当前计划的每日限制X-RateLimit-Remaining:每日定额的剩余量X-RateLimit-Reset:配额重新设置时
注意:如果你正在使用我们的sdk，你可以使用以下方法来检索上面的值:
打印客户端．RateLimits（）把客户端．rate_limitsvar限制＝客户端．RateLimit控制台．WriteLine（”限制:“+限制［“限制”]);控制台．WriteLine（“剩下的:“+限制［“剩余的”]);控制台．WriteLine（“重置:“+限制［“重置”]);textapi．情绪({＇文本＇：＇约翰是一个非常好的足球运动员＇，函数（犯错，结果，rateLimits）｛控制台．日志（rateLimits）;})；<？phpvar_dump（textapi美元->getRateLimits());? >TextAPIClient．RateLimitsrateLimits＝客户端．getRateLimits();系统．出．println（rateLimits．getLimit());系统．出．println（rateLimits．getRemaining());系统．出．println（rateLimits．getReset());fmt．Printf（“% v\ n＂，客户端．RateLimits）检索应用程序中剩余的配额
HTTP状态
除了API响应的HTTP方法外，它还将返回标准的HTTP状态，包括错误代码。
在出现问题时，状态将包含错误代码，而响应的主体通常包含关于遇到的问题的附加信息。
通常，如果返回的状态在200范围内，则表示请求成功完成，没有遇到错误。
返回代码在400范围内通常表明所发送的请求有问题。除此之外，这可能意味着您没有正确地进行身份验证，您正在请求一个您没有授权的操作，您正在请求的对象不存在，或者您的请求格式不正确。
如果您收到的状态在500范围内，这通常表明是服务器端问题。这意味着我们这边有问题，目前无法满足您的要求。
错误码与响应
| 代码 | 文本 | 描述 |
|---|---|---|
| 200 | 好吧 | 成功! |
| 400 | 坏的请求 | 由于明显的客户端错误，服务器不能或将不处理请求。 |
| 401 | 未经授权的 | 身份验证凭据缺失或不正确。 |
| 404 | 没有找到 | 请求的URI无效或请求的资源不存在。 |
| 405 | 方法不允许 | 请求方法不支持被请求的资源。 |
| 410 | 走了 | 请求的URI不再可用 |
| 414 | URI的时间太长 | 提供的URI太长，服务器无法处理。 |
| 422 | Unprocessable实体 | 请求无效或无法以其他方式处理。 |
| 429 | 太多的请求 | 超过使用限制。 |
| 500 | 内部服务器错误 | 发生意外错误，已通知工程师。如果您继续遇到问题，请联系[support@www.daredevilro.net][4]。 |
| 503 | 服务不可用 | 服务器目前不可用(因为它超载或停机维护)。 |
| 504 | 网关超时 | 服务器无法及时得到响应，可能是因为网页被屏蔽或在付费墙后面。 |
语言支持
文本分析API支持多种(人类)语言，可以使用语言参数，大多数端点都支持。有效的语言代码请参考下表:
| 英语 | 德国 | 法国 | 意大利 | 西班牙语 | 葡萄牙语 | |
|---|---|---|---|---|---|---|
语言代码（语言） |
在 |
德 |
fr |
它 |
西文 |
pt |
下表显示了当前跨API的不同端点支持的语言。
| 端点 | 英语 | 德国 | 法国 | 意大利 | 西班牙语 | 葡萄牙语 |
|---|---|---|---|---|---|---|
| 文章提取 |
|
|
|
|
|
|
| 摘要 |
|
|
|
|
|
|
| 分类 |
|
|
|
|
|
|
| 情绪分析 |
|
|
|
|
|
|
| 实体提取 |
|
|
|
|
|
|
| 概念提取 |
|
|
|
|
|
|
| 标签的建议 |
|
|
|
|
|
|
| 语言检测 |
|
|
|
|
|
|
各种各样的信息
报告问题
与其他数据驱动系统一样，从Text Analysis API获得的结果可能时不时地包含错误。如果您注意到任何系统性或重大错误，请使用这种形式我们会在适当的时候进行审查。
常见问题
我如何检索我的API密钥和应用程序ID?
登录您的开发人员门户使用您在注册使用API时使用的凭证。
API支持哪些语言?
请参阅我们的语言支持上面的部分。
我已经注册了自由计划，我的帐户是否有任何限制?
在免费计划中，你可以在限定的时间内每天对API进行最多1000次点击。
我想开始使用图像标记端点，我如何启用该功能?
您需要升级到付费计划才能开始调用Image Tagging端点。更多关于付费计划的信息可以在这里找到在这里．
如何查询我的利率上限?
请参阅速度限制部分。
如何切换到推特模式情绪分析?
你可以切换到推特在情绪模式中添加一个模式=推参数到您的请求。
我的结果并不总是准确的。为什么?
与任何其他数据驱动系统一样，我们的API可能会时不时地出错。请使用这种形式．
我如何改变我从你的API得到的结果的格式?
默认情况下，API返回JSON结果。但是，您可以请求JSON或XML格式的结果。请参阅结果格式部分查看更多信息。
如何升级到更大的计划?
升级到更大的计划很容易。登录您的开发人员门户，导航到Plans部分，并选择您希望升级到的计划。请注意，您只有在输入信用卡信息后才能更改计划。
如何记录支持查询?
你可以给我们发邮件support@www.daredevilro.net或者使用屏幕右下角的聊天小部件报告您可能遇到的任何问题。
我可以直接调用API(即不使用任何sdk)吗?
是的!请参考使用．