∙API参数集
用户通过指定API参数来获取对应的结果，语言云服务的API参数集如下表所示： 参数名 | 含义 | 说明 |
api_key | 用户注册语音云服务后获得的认证标识 | |
text | 待分析的文本 | 请以UTF-8格式编码，GET方式最大10K，POST方式最大20K |
pattern | 用以指定分析模式，可选值包括ws(分词)，pos(词性标注)，ner(命名实体识别)，dp(依存句法分析)，srl(语义角标注),all(全部任务) | plain格式中不允许指定全部任务 |
format防尘机箱 | 用以指定结果格式类型，可选值包括xml(XML格式)，json(JSON格式)，conll(CONLL格式)，txueplain(简洁文本格式) | |
xml_input | 用以指定输入text是否是xml格式，可选值为false(默认值),true | 仅限POST方式 |
has_key | 用以指定json结果中是否含有键值，可选值包括true(含有键值，默认)，false(不含有键值) | 配合format=json使用 |
only_ner | 用以指定plain格式中是否只需要ner列表，可选值包括false(默认值)和true | 配合pattern=ner&format=plain使用 |
callback | 用以指定JavaScript调用中所使用的回调函数名称 | 配合format=json使用 |
| | |
******************************************************************************
∙调用方式
用户可以用两种方式来调用API，直接使用REST | 在JavaScript中使用REST
REST
REST,或者叫做Representational State Transfer，在语言云API中并不等同于传统的REST。传统的REST提供对于资源的访问，而语言云REST API提供对于服务的访问。因此，在语言云API中，一个单独的URI就是一个服务端点。
在语言云中，所有的API访问都是通过HTTP请求的方式。并且需要从ltpapi.voicecloud域进行访问。语言云只支持GET和POST方式的HTTP请求。用户通过在HTTP请求中指定参数来获取对应的结果。
举个例子，对“我是中国人。”这句话做依存句法分析，并且返回plain格式的结果。
药草香GET请求及返回结果示例：
$ curl -i "ltpapi.voicecloud/analysis/?api_key=YourApiKey&text=我是中国人。&pattern=dp&format=plain"
HTTP/1.1 200 OK
Server: nginx/1.1.19
Date: Fri, 03 Jan 2014 04:24:32 GMT高瓦纸
Content-Type: text/plain
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
是_1 -1 HED
中国_2 人_3 ATT
人_3 是_1 VOB
POST请求及返回结果示例：
$ curl -i -d "api_key=YourApiKey&text=我是中国人。&pattern=dp&format=plain" "ltpapi.voicecloud/analysis/"
HTTP/1.1 200 OK
测量电池内阻
Server: nginx/1.1.19
Date: Fri, 03 Jan 2014 05:58:55 GMT
Content-Type: text/plain
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
我_0 是_1 SBV
是_1 -1 HED
中国_2 人_3 ATT
人_3 是_1 VOB
使用Python语言以GET方式调用REST API代码示例如下：
1. # -*- coding:utf8 -*-
2.import urllib2
3.if __name__ == 电机线圈绕线机'__main__':
4. url_get_base = "ltpapi.voicecloud/analysis/?"
5. api_key = ''
6. text = ''
7. format = ''
8. pattern = ''
9. result = urllib2.urlopen( "%sapi_key=%s&text=%s&format=%s&pattern=%s" % (url_get_base,api_key,text,format,pattern))
10. content = ad().strip()
11. print content
更多使用其他编程语言以GET和POST方式调用REST API代码示例以及注意事项请参考API编程调用示例。
JavaScript调用REST
语言云支持用户使用JavaScript以JSON-P回调的方式调用API，用户需要以GET方式进行调用并且只支持json的返回格式。
在此方式中，需要用户在uri中添加callback参数并且在js中指定相同名称的回调函数进行结果的捕捉，这通常用于跨域访问使得结果嵌入到Web页面中。
$ curl -i "ltpapi.voicecloud/analysis/?api_key=YourApiKey&text=我是中国人。&pattern=dp&format=json&callback=foo"
HTTP/1.1 200 OK
Server: nginx/1.1.19
Date: Fri, 03 Jan 2014 08:08:56 GMT
Content-Type: application/javascript
Transfer-Encoding: chunked
豫公网安备41160202000603
站长QQ:729038198
关于我们
投诉建议