深度分析 > 实验功能使用 > 节点 > WEB服务 > REST请求和REST响应

使用REST API的过程中，需要了解请求和响应的格式，以下几点补充说明了此接口的功能。

•更新REST请求节点的数据

请求地址		http://ip:port/bi/rest/v1/experiment/node ➢注意：此地址为创建好实验后，服务配置内自动生成的地址，格式统一，通过参数的设置来完成对实验的调用。
请求消息	请求参数	必填，QueryParam为节点的apiKey，BodyParam为需要更新的数据。
	参数描述	apiKey为创建节点时自动生成的用于标识当前节点的字符串；BodyParam为client端发送给server端用于更新apiKey所指定的节点的数据，数据格式见Body格式说明。当前版本支持Byte、Short、Integer、Long、Float、Double、Boolean、Character、String、Date、Time和Timestamp一共12种数据格式。
	示例	function updateInputNodeData () { $.post("http://" + ip + ":" + port + "/" + project + "/rest/v1/experiment/node?apiKey=xxx", {}, function(result) { writeJson(result); }); }
响应消息	响应结果	•服务未启动 { "success": false, "code": 20002, "message": "服务未启动" } •接口正常响应 { "msgId":"4a32a2a259f44093bdad6d13dfca1834", "success":true, "code":20000, "message":"成功", "content":[ { "fieldName":"A", "fieldType":"Byte", "fieldData":[ 2 ] } ] }
响应消息	结果描述	响应结果信息为json格式。 •success表示响应状态，true表示参数合法且业务流程正常处理，否则，返回false。 •code表示返回状态码，不同数值代表不同的返回状态，见下面的响应消息code描述。 •message为接口操作结果信息，成功时显示“成功”，失败时则展示错误信息。 •content为接口返回的数据。

•请求的Body的格式

用户通过POST请求调用接口时传递的Body需要满足json格式，如下，其中fieldName为传递的列名，fieldType为数据类型，fieldData为数据。

当前版本支持Byte、Short、Integer、Long、Float、Double、Boolean、Character、String、Date、Time和Timestamp一共12种数据格式。

Body格式

{

"fieldList": [{

"fieldName": "A",

"fieldType": "Byte",

"fieldData": [2]

}, {

"fieldName": "B",

"fieldType": "Short",

"fieldData": [4, 5]

}, {

"fieldName": "C",

"fieldType": "Integer",

"fieldData": [6, 7, 8]

}, {

"fieldName": "D",

"fieldType": "Long",

"fieldData": [9, 10, 11, 12]

}, {

"fieldName": "E",

"fieldType": "Float",

"fieldData": [13.01, 14.02, 15.03, 16.04]

}, {

"fieldName": "F",

"fieldType": "Double",

"fieldData": [17.04, 18.05, 19.06, 20.07, 21.08]

}, {

"fieldName": "G",

"fieldType": "Boolean",

"fieldData": [true, false, true, false, true, false]

}, {

"fieldName": "H",

"fieldType": "String",

"fieldData": ["a", "b", "c", "d", "e", "f", "g"]

}]

}

以上参数在产品中可以在Rest请求节点的【配置项目 > 测试数据】中输入，运行后可通过连接数据集视图查看数据。

DepthAnalysis_RESTAPIIllustrate1

•响应消息code描述

CODE	说明
code = 20000	表示操作成功
code = 20001	表示license不合法
code = 20002	表示服务未启动
code = 20003	表示请求参数错误
code = 20004	表示服务被中断
code = 20005	表示未知错误

REST API 各方法说明

REST API 各方法说明