检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
公共请求参数 表1 公共请求消息头 参数名 说明 必选 示例 Content-type 发送的实体的MIME类型。 是 application/json Content-Length 请求body长度,单位为Byte。 POST/PUT请求为可选, GET不包含。 3495 X-Auth-Token
构造请求 本节介绍REST API请求的组成,讲述如何调用API接口。 请求示例如下所示,一个请求主要由请求URL、请求方法、请求消息头和请求消息体几部分组成,各个部分将在下文详细解释。 图1 请求示例图 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint}
Postman是网页调试与辅助接口调用的工具,具有界面简洁清晰、操作方便快捷的特性,可以处理用户发送的HTTP请求,例如:GET,PUT、POST,DELETE等,支持用户修改HTTP请求中的参数并返回响应数据。 Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于NLP服务接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同
取Token方式,请参考获取用户Token。 获取用户Token接口请求构造如下,您可以从接口的请求部分看到所需的请求参数及参数说明。获取Token消息头只需填写“Content-Type”,将消息体加入后的请求如下所示。 加粗的斜体字段需要根据实际值填写,其中username为
调用说明 自然语言处理服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
状态码 正常 200 异常 返回值 说明 400 Bad Request 请求错误,具体返回错误码请参考错误码。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。 500 Internal Server Error 服务内部错误。 503 Service
效。 Body 通过切换输入方式可以选择表单填写或文本输入请求体。 表单填写:通过表单填写完成请求体,无需了解JSON语法,参考示例填写参数值。 文本输入:通过文本输入完成请求体,可以直接在编辑框内编写JSON格式的请求体。 { "auth": { "identity":
如何访问自然语言处理服务 公有云提供了Web化的服务管理平台,即管理控制台和基于HTTPS请求的API(Application programming interface)管理方式。 API方式 如果用户需要将公有云平台上的自然语言处理服务集成到第三方系统,用于二次开发,请使用A
NLP.0301 query param error 请求参数异常。 检查请求参数字段名,修改正确后重新尝试。 400 NLP.0303 request method not support http请求方式不支持。 检查请求方式,修改正确后重新尝试。 400 NLP.0304 http
有哪些途径可以使用自然语言处理的API? 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 名称 是否必选 参数类型 说明 content 是 String 请求文本,用于检查指定实体(entity)在该请求文本中的正负面分析。 仅支持中文,文本编码要求为utf-8。请求文本内容不能为空,且请求文本与请求实体的长度
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 目前自然语言处理基础、语言生成、语言理解和机器翻译服务支持以下地区和终端节点: 表1 自然语言处理基础、语言生成、语言理解和机器翻译服务 区域名称 区域 终端节点(Endpoint)
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text String 是 待分析文本,中文长度为1~512,英文和西班牙文长度为1~2000,文本编码为UTF-8。
参数说明 表1 URI参数说明 名称 是否必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如下所示。 表2 请求参数 名称 是否必选 参数类型 说明 type 是 Integer 诗歌类型,取值如下: 0:五言绝句 1:七言绝句 2:五言律诗
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text1 String 是 待计算文本1,长度1~64,文本编码为UTF-8。 text2
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分析文本。文本编码要求为utf-8。 限定180
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分析文本,UTF-8编码,限定400个字符以内,
项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表 请求参数所示。 表2 请求参数 参数名 参数类型 必选 说明 text String 是 待分析文本,长度为1~512,文本编码为UTF-8。 limit integer 否 返回关键词的最大数量,默认为5。 如果请求文本的词汇数量小于该值,则返回实际词汇数量。
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表 请求参数所示。 表2 请求参数 参数名 参数类型 必选 说明 text String 是 待分析文本,长度为1~64,文本编码为UTF-8。 lang