REST API 各方法说明

<< Click to Display Table of Contents >>

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

REST API 各方法说明

复制链接

使用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"]

}]

}

以上参数在产品中可以通过定义配置服务的测试代码,并通过测试保存后连接数据集视图进行展示。如下图:

DepthAnalysis_RESTAPIIllustrate3

DepthAnalysis_RESTAPIIllustrate1

DepthAnalysis_RESTAPIIllustrate2

响应消息code描述

CODE

说明

code = 20000

表示操作成功

code = 20001

表示license不合法

code = 20002

表示服务未启动

code = 20003

表示请求参数错误

code = 20004

表示服务被中断

code = 20005

表示未知错误