承载协议 | HTTPS GET |
|---|---|
接口方向 | 应用服务器或App应用 -> 近距离通信服务器 |
接口URL | https://{域名}/WiseCloudNearbyBeaconService/v1/queryNamespace?projectId=[projectId] |
数据格式 | Content-type: application/json |
Request Header
参数 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
timeStamp | 是 | Long | 请求头参数,时间戳。 |
srcTranID | 是 | String | 请求头参数,事务ID,最长为24个字符。 |
Authorization | 是 | String | 请求头参数,用于网关认证,请参见基于Service Account开放鉴权获取JWT。 |
Request Body
无
GET /WiseCloudNearbyBeaconService/v1/queryNamespace?projectId=id123 HTTP/1.1 Host: 域名 Content-Type: application/json Authorization: Bearer eyJraWQiOiIx---xxx.eyJhdWQiOiJodHR---xxx.QRodgXghghSa2xeXSt4Gp---xxx srcTranID: 202001141709412953357215 timeStamp: 922337203685477580 Accept: application/json
GET /WiseCloudNearbyBeaconService/v1/queryNamespace?projectId=id123 HTTP/1.1 Host: 域名 Content-Type: application/json Authorization: Bearer eyJraWQiOiIx---xxx.eyJhdWQiOiJodHR---xxx.QRodgXa2xeXSt4Gp---xxx srcTranID: 202001141709412953357215 timeStamp: 922337203685477580 Accept: application/json
GET /WiseCloudNearbyBeaconService/v1/queryNamespace?projectId=id123 HTTP/1.1 Host: 域名 Content-Type: application/json Authorization: Bearer eyJraWQiOiIx---xxx.eyJhdWQiOiJodHR---xxx.QRodgXa2xeXSt4Gp---xxx srcTranID: 202001141709412953357215 timeStamp: 922337203685477580 Accept: application/json
Response Header
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 否 | String | 上传文件Content-Type。 |
Content-Length | 是 | Integer | 上传文件Content-Length。 |
Response Body
状态码为200时:
请求成功,响应体如下。
参数 | 类型 | 描述 |
|---|---|---|
namespaces | Json Array | 命名空间结构体的列表,具体参见命名空间结构体定义。 |
{
"visibility": "PRIVATE",
"namespace": "dev9105385871708487577"
} 参数值 | 类型 | 功能 |
|---|---|---|
visibility | String | 命名空间可见性。
|
namespace | String | 命名空间。 |
状态码为非200时:
参数 | 类型 | 描述 |
|---|---|---|
error | String | 非业务返回的错误信息。 |
参数 | 类型 | 描述 |
|---|---|---|
serviceError | object | 业务返回的错误信息。请见下文serviceError详细信息。 |
HTTP/1.1 401
Content-Type: application/json
Content-Length: 27
{
"error": "session timeout"
} HTTP/1.1 403
Content-Type: application/json
Content-Length: 84
{
"serviceError": {
"code": 403000003,
"message": "The service account is unavailable.",
"status": "Forbidden"
}
} HTTP/1.1 200
Content-Type: application/json
Content-Length: 61
{
"namespaces": [
{
"visibility": "PRIVATE",
"namespace": "dev9105385871708487577"
}
]
} 状态码 | 错误码 | 描述 | 建议业务处理方式 |
|---|---|---|---|
400 | 400000001 | 请求头参数不对。 | 检查请求头参数。 |
403 | 403000003 | 服务帐号不可用。 | 在华为开发者联盟的管理中心可查看服务帐号状态。 |
500 | 500000001 | 内部服务错误。 | 请选择在线提单提交问题,华为支持人员会及时处理。 |