目录

查询信标设备详细信息

功能介绍

查询信标设备的详细信息。

场景描述

调用此接口进行查询信标设备的详细信息。

使用约束

需要获取服务帐号凭证,请参见基于Service Account开放鉴权。

接口原型

承载协议

HTTPS GET

接口方向

应用服务器或App应用 -> 近距离通信服务器

接口URL

https://{域名}/WiseCloudNearbyBeaconService/v1/queryBeaconInfo/{beaconId}?projectId=[projectId]

数据格式

Content-type: application/json

路径参数

参数

是否必选

参数类型

描述

beaconId

是

String

信标设备的ID。

查询参数

参数

是否必选

参数类型

描述

projectId

否

String

获取方式请参见获取projectId。

请求参数

Request Header

参数名

是否必选

类型

描述

srcTranID

是

String

请求头参数,事务ID。最长为24个字符。

timeStamp

是

Long

请求头参数,时间戳。

Authorization

是

String

请求头参数,用于网关认证,请参见基于Service Account开放鉴权获取JWT。

Request Body

无

请求示例

响应参数

Response Header

参数

是否必选

参数类型

描述

Content-Type

否

String

上传文件Content-Type。

Content-Length

是

Integer

上传文件Content-Length。

Response Body

状态码为200时:

请求成功,响应体如下。

参数

类型

描述

beacon

object

信标设备的详情信息。

具体参见信标设备数据模型。

状态码为非200时:

请求失败,响应体如下。

响应示例

错误码

状态码

错误码

描述

建议业务处理方式

400

400000001

请求头参数不对。

检查请求头参数。

400

400000002

请求体参数不对。

检查请求体参数。

403

403000003

服务帐号不可用。

在华为开发者联盟的管理中心可查看服务帐号状态。

403

403000004

当前帐号没有权限操作此信标设备。

检查此帐号是否有权限操作。

404

404000006

当前信标设备不存在。

检查该当前的信标设备是否注册过,若无请先注册。

500

500000001

内部服务错误。

请选择在线提单提交问题,华为支持人员会及时处理。