# 布控球转动（API名称：openApiSendImMessage） #### 功能介绍用于与客户系统对接布控球转动接口服务。 #### 相关API | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | #### URL | 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 | |:---|:---|:---|:---| | POST | https://***isdp+域名***/openapi/v1/openSendImMessage/openApiSendImMessage | 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的值 | #### 请求参数 | 参数 | 类型 | 是否必填 | 描述 | |:---|:---|:---|:---| | message | String | 是 | 根据需求有所变化，详情见下方请求示例 | #### 响应参数 | 参数 | 类型 | 描述 | |:---|:---|:---| | result | Object | 响应消息体 | | errorMessage | String | 接口错误时有值，正常调用时为空 | | stateCode | String | "0"成功其他值失败 | #### 请求示例（布控球转动例子）注：标红部分的是账号需要修改，759646@saasgroupchat.xxxx.test.huawei.com为设备的chatJid；1663658550096是一个随机数UUID；http://xxxx.test.huawei.com仅为sit示例，具体地址视现场openfire服务而定；864711是userID； zhang_sit是userName；Zhang123456是操作人；aqm0523接收设备；蓝色部分是发送指令；绿色部分是租户id。 ``` {"message":"布控球方位调整!helmet-ball-Y2-commandtext无牙仔helmet-ball-Y2-command{"command":"turn","value":"left","userId":864711,"userName":"zhang_sit","userNo":"Zhang123456","tenantId":886,"uid":"f75fe2a6ec0c404f98de3d18e88fb736","channelId":"33358871****805","deviceId":"f20909","isdpDeviceId":"f20909--1"}"} ``` #### 响应示例 ``` { "stateCode": "0", "errorMessage": null, "result": null } ``` #### 状态码状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。