文档中心

接口描述

用于自动分析用户评论的情感倾向性，并给出评论观点的情感极性类别（积极或消极）

接口要求

文本格式：

1. 单段文本长度不超过256，编码格式为UTF-8编码

2. 仅支持简体中文

请求说明

• 请求示例

HTTP方法：POST

请求URL：https://ai.ctyun.cn/v1/aiop/api/[系统生成的服务码]/text/textanalyse/api/sentiment

• 请求头说明

参数	值(说明)
Content-Type	application/json
Sign	MD5(AppKey   + AppSecret + Timestamp + Path + Http Body)，32位小写的MD5加密串
Timestamp	13位时间戳
AppKey	平台分配给应用独立的AppKey

请求参数

参数	是否必选	类型	可选值范围	说明
data	true	string	-	请求参数放置于http body中，为待分析的文本字符串

• 请求示例代码

Bash：

curl -X POST https://ai.ctyun.cn/v1/aiop/api/[系统生成的服务码]/text/textanalyse/api/sentiment -H "Content-Type: application/json" -H 'Sign: XXXXX' -H 'Timestamp: XXXXX' -H 'AppKey: XXXXX' --data '{"data": "string"}'

Python：

# -*- coding: utf-8 -*-

import requests

import base64

import hashlib

import time

import json

'''

文本情感分析

'''

def md5(key):

input_name = hashlib.md5()

input_name.update(key.encode("utf-8"))

return input_name.hexdigest()

request_url = "文本情感分析的API URL"

params = {"data": "待分析的文本"}

app_key = '平台分配的APP Key'

app_secret = '平台分配的APP Secret '

time_stamp = str(int(round(time.time() * 1000)))

headers = {

'content-type': 'application/json',

'Sign': md5(app_key + app_secret + time_stamp + '/v1/aiop/api/[系统生成的服务码]/text/textanalyse/api/sentiment' + json.dumps(params)),

'Timestamp': time_stamp,

'AppKey': app_key

}

response = requests.post(request_url, data=json.dumps(params), headers=headers)

if response:

print(response.json())

返回说明

• API调用成功返回值

返回字段	是否必选	类型	字段说明
code	true	int	返回状态，返回0表示成功
message	true	string	返回对应的可读消息，值为success
result	true	object	API具体返回信息
pro_neg	true	float	文本中消极倾向概率
pro_pos	true	float	文本中积极倾向概率

• API调用失败返回值

返回字段	是否必选	类型	字段说明
code	true	int	错误码，参见本文档错误码说明部分
message	true	string	返回对应的可读消息，值为error
details	true	string	错误消息

• 返回示例

HTTP/1.1 200 OK

Content-Type: application/json

{

'code': 0,

'message': 'success',

'result': {

"pro_neg" : 0.23586,

"pro_pos" : 0.76414

}

}

错误码说明

错误代码	错误消息	错误可能原因
4001	请求中未包含文本	请求体中未传入待分析的有效文本字符串
4002	请求参数异常	请求的参数格式不正确或者参数名错误
4003	请求的API URL不存在	请求路径非指定路径
4004	单条文本长度超过限度	传递的文本超过规定的最大文本长度，最大长度为255
4005	请求文本为非法字符串	传递的文本中存在大量的非中文字符，非中文字符占比不能超过50%
4006	请求方法非指定方法	请求方法非指定的POST方法
5000	服务内部错误	服务内部发生错误，需要联系管理员处理