# 新增IVS1800/IVS3800（API名称：addIntegrationDevice）
#### 功能介绍
新增IVS1800/IVS3800用到的接口。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                             | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/IntegrationDevice/addIntegrationDevice | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**          | **类型** | **是否必填** | **描述**                                     |
|:---|:---|:---|:---|
| deviceType      | String | 是        | 设备类型                                       |
| deviceName      | String | 是        | 设备名称                                       |
| ivsLoginUrl     | String | 是        | 设备登录url，格式 ： ip+端口 ，例 ： "192.168.1.1:8080" |
| ivsLoginAccount | String | 是        | 设备登录用户名                                    |
| ivsLoginPsw     | String | 是        | 设备登录密码                                     |
| buOrgId         | Long   | 是        | 组织Id                                       |
| buOrgName       | String | 是        | 组织名称                                       |
| projectNumber   | String | 否        | 项目编码                                       |
| projectName     | String | 否        | 项目名称                                       |
   
#### 响应参数
| **参数**    | **类型** | **描述**                |
|:---|:---|:---|
| status    | Int    | 响应状态，1标识成功，否则不成功      |
| message   | String | 响应信息，SUCCESS标识成功，否则失败 |
| error     | String | 错误信息，接口错误时有值，正常调用时为空  |
| data      | String | 响应消息体                 |
| timestamp | String | 响应时间                  |
   
#### 请求示例
```
{
"deviceType" : "IVS1800",
"deviceName" : "testIvs1800",
"ivsLoginUrl": "10.91.172.64:18531",
"ivsLoginAccount" : "dianli0615",
"ivsLoginPsw" : "isdp@123",
"buOrgId" : 830,
"buOrgName" : "杨凌作业系统测试",
"projectNumber" : "",
"projectName" : ""
}
```
#### 响应示例
```
{
"status": 1,
"message": "添加集成设备成功",
"error": "success",
"data": null,
"timestamp": "2022-05-20T20:39:54.343+0800"
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。