注册LoRa网关
接口说明
loraServer网关上线后，注册LoRa网关。
注意事项
应用已鉴权，在header中携带参数app_key和Authorization: Bearer {accessToken}
URI
|
请求方法 |
POST |
|---|---|
|
URI |
/api/v3.0/devices/lora/gateway |
|
传输协议 |
HTTPS |
请求参数
|
名称 |
必选/可选 |
类型 |
位置 |
说明 |
|---|---|---|---|---|
|
app_key |
必选 |
String |
Header |
已鉴权应用的appId |
|
Authorization |
必选 |
String |
Header |
请求的认证信息，值为“Bearer ******”，其中******为Auth鉴权接口返回的accessToken |
|
ownerAppId |
可选 |
String(36) |
Body |
LoRa网关所属的应用ID，当添加授权应用下的LoRa网关时需要填写。 |
|
loraServerId |
必选 |
String |
Body |
LoRaServer接入物联网的标识，由物联网平台分配。 |
|
productId |
必选 |
String |
Body |
LoRa网关关联的产品ID，用于唯一标识一个产品模型。 |
|
gatewayEUI |
必选 |
String |
Body |
LoRa网关唯一标识，16位hex类型。 |
|
name |
必选 |
String |
Body |
LoRa网关名称。 |
|
gatewaySeq |
可选 |
String |
Body |
LoRa网关接入码，32位hex类型，结合gatewayEUI由LoRa服务商统一生成。 |
响应参数
|
名称 |
类型 |
说明 |
|---|---|---|
|
deviceId |
String |
设备ID，用于唯一标识一个设备，在注册LoRa网关时由物联网平台分配获得。 |
|
loraServerId |
String |
LoRaServer接入物联网的标识，由物联网平台分配。 |
|
productId |
String |
LoRa网关关联的产品ID，用于唯一标识一个产品模型。 |
|
gatewayEUI |
String |
LoRa网关唯一标识，16位hex类型。 |
|
name |
String |
LoRa网关名称。 |
|
gatewaySeq |
String |
LoRa网关接入码，32位hex类型，结合gatewayEUI由LoRa服务商统一生成。 |
请求示例
POST https://{host}:{port}/api/v3.0/devices/lora/gateway
Content-Type: application/json
app_key: ********
Authorization: ********
{
"ownerAppId" : "string",
"loraServerId" : "string",
"productId" : "string",
"gatewayEUI" : "string",
"name" : "string",
"gatewaySeq" : "string"
}
响应示例
Status Code: 201 Created
Content-Type: application/json
{
"deviceId" : "string",
"loraServerId" : "string",
"productId" : "string",
"gatewayEUI" : "string",
"name" : "string",
"gatewaySeq" : "string"
}
错误码
|
HTTP状态码 |
HTTP状态码说明 |
错误码 |
错误码描述 |
|---|---|---|---|
|
201 |
Created |
- |
- |
|
400 |
Bad Request |
106018 |
the product not exist. |
|
1200013 |
The LoRa gateway already exists. |
||
|
1200014 |
The LoRa Server processing failed:% |
||
|
403 |
Forbidden |
100217 |
The application hasn't been authorized. |
|
100249 |
The operation is not allowed.The application does not have edit permission. |
||
|
1200006 |
The operation is not allowed. The LoRa Server is not online. |
||
|
1200007 |
The operation is not allowed. The protocol of the product model is not LoRaWAN. |
||
|
1200015 |
The operation is not allowed. The deviceType of the product model must be LoRaGateway. |
||
|
1200019 |
The operation is not allowed. The gatewayEUI is duplicated. |
||
|
404 |
Not Found |
100203 |
The application is not existed. |
|
1200017 |
The LoRa Server is not existed. |
||
|
500 |
Internal server error |
100001 |
Internal server error. |
|
100220 |
Get AppKey from header failed. |
||
|
1200001 |
Failed to register the LoRa gateway. |
