项目管理

1. 获取项目列表

1.1 接口地址

【GET】 /uba/manage/enterprise/projects

1.2 请求参数示例

无

认证参数：接口必传 xtoken 参数，详情见 平台接口认证。

操作用户：接口如果要记录操作人，URL上带loginUser参数，详情见 操作用户。

1.3 返回结果示例

[
    {
        "appKey": "streamingut608",
        "normalToken":"xxxx",
        "cname": "streaming单元测试项目",
        "version": "4.2.7",
        //以下字段在【4.5.1版本】中新增
        "logo": "/data/static/files/logo/aaa.png",
        "createTime": 1578901233445,
        "sdkBack": "iOS,Android,H5",
        "status": 1,
        "partitionNum": 3,
        "stream": 0
    }
]

1.3.1 出参说明：

参数名称	类型	说明
appKey	String	项目AppKey
normalToken	String	项目内接口授权码
cname	String	项目名称，用于展示
version	String	项目当前版本信息
logo	String	项目图标访问路径，默认不显示，只有上传logo后显示
createTime	Long	十三位时间戳
sdkBack	String	已回数SDK接入平台(如 Java,JS,Android )，未回数时不显示
status	int	项目状态；1表示正常，2表示已删除，3表示异常不可用，只返回状态值1的项目
partitionNum	int	数据存储分区数
stream	int	项目数据数据流状态；0表示未启动，1表示启动中，2表示已启动，3表示异常中断，5表示关闭中

1.4 接口调用示例

curl -H "Content-Type:application/json" -H "xtoken:9CF0444E9DFD9E3D9CAE49B79F939B61" -X GET http://127.0.0.1:4005/uba/manage/enterprise/projects

2. 获取单个项目详细

2.1 接口地址

【GET】 /uba/manage/enterprise/projects/{appKey}

2.2 请求参数示例

无

认证参数：接口必传 xtoken 参数，详情见 平台接口认证。

操作用户：接口如果要记录操作人，URL上带loginUser参数，详情见 操作用户。

2.2.1 入参说明：

参数名称	类型	必填	说明
appKey	String	Y	项目App标识，备注：URL传参

2.3 返回结果示例

{
    "appKey":"streamingut608",
    "cname":"streaming单元测试项目",
    "version":"4.2.7",
    "logo":"/data/static/files/logo/aaa.png",
    "createTime":1578901233445,
    "sdkBack":"iOS,Android,H5",
    "status":1,
    "partitionNum":3,
    "stream":0
}

2.3.1 出参说明：

参数名称	类型	说明
appKey	String	项目AppKey
cname	String	项目名称，用于展示
version	String	项目当前版本信息
logo	String	项目图标访问路径，默认不显示，只有上传logo后显示
createTime	Long	十三位时间戳
sdkBack	String	已回数SDK接入平台(如 Java,JS,Android )，未回数时不显示
status	int	项目状态； 1表示正常，2表示已删除，3表示异常不可用，只返回状态值1的项目
partitionNum	int	数据存储分区数
stream	int	项目数据数据流状态；0表示未启动，1表示启动中，2表示已启动，3表示异常中断，5表示关闭中

2.4 接口调用示例

curl -H "Content-Type:application/json" -H "xtoken:9CF0444E9DFD9E3D9CAE49B79F939B61" -X GET http://127.0.0.1:4005/uba/manage/enterprise/projects/streamingut608

3. 创建新项目

3.1 接口地址

【POST】 /uba/manage/enterprise/projects

3.2 请求参数示例

{
      "appKey":" streamingut608",
      "name":"测试项目"
}

认证参数：接口必传 xtoken 参数，详情见 平台接口认证。

操作用户：接口如果要记录操作人，URL上带loginUser参数，详情见 操作用户。

3.2.1 入参说明：

参数名称	类型	必填	说明
appKey	String	Y	新项目的AppKey标识，只接受英文数字组合，不传系统自动生成。 备注：Body参数
name	String	Y	项目名称，只接受英文数字组合。

3.3 返回结果示例

{
    "appKey": "streamingut608",
    "success": 0
}

3.3.1 出参说明：

参数名称	类型	说明
appKey	String	项目AppKey
success	Integer	0表示创建完成，无异常。 备注：因为项目创建需要调配非常多系统资源，所以该接口为异步操作，项目真正可用状态需要调用【项目详情】接口，其中status 字段表示项目创建情况

3.4 接口调用示例

curl -H "Content-Type:application/json" -H "xtoken:9CF0444E9DFD9E3D9CAE49B79F939B61" -X POST --data '{" appKey ":" streamingut608","name ":"测试项目"}'  http://127.0.0.1:4005/uba/manage/enterprise/projects

4 开启/关闭数据流

4.1 接口地址

【POST】 /uba/manage/enterprise/projects/{appKey}/stream

4.2 请求参数示例

{
    //数据流状态 true为开启数据流 false为关闭数据流 关闭数据流功能在4.5版本中新增
    "streamSwitch": true
}

认证参数：接口必传 xtoken 参数，详情见 平台接口认证。

操作用户：接口如果要记录操作人，URL上带loginUser参数，详情见 操作用户。

4.2.1 入参说明：

参数名称	类型	必填	说明	枚举
appKey	String	Y	新项目的AppKey标识，只接受英文数字组合，不传系统自动生成。备注：URL参数
streamSwitch	Boolean	Y	数据流状态 true为开启数据流，false为关闭数据流。 备注：关闭数据流在4.5版本中才会支持。	true/false

4.3 返回结果示例

{
  //0表示操作成功，数据流开启/关闭中
  "success": 0
}

4.3.1 出参说明：

参数名称	类型	说明
success	Integer	0表示操作成功，数据流开启/关闭中。备注：因为开启数据流/关闭数据流是异步操作，接口调用只是发起了相关请求，最终的操作结果需要通过streamStatus查看最终启停状态。

4.4 接口调用示例

curl -H "Content-Type:application/json" -H "xtoken:E1E967DCE07B10839F87195B78E1F5F5" -X POST --data '{
    "streamSwitch": true
}' http://127.0.0.1:4005/uba/manage/enterprise/projects/streamingut608/stream?loginUser=[e-mail]