调用该接口获取某条节点上下行数据包。
限制说明
单阿里云账号调用该接口的每秒请求数(QPS)最大限制为5。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetNodeTransferPacket |
系统规定参数。取值:GetNodeTransferPacket。 |
IotInstanceId | String | 否 | iot-cn-0pp1n8t**** |
实例ID。 您可在物联网平台控制台的实例概览页面,查看当前实例的ID。若有ID值,必须传入该ID值,否则调用会失败。 说明 如果公共实例没有ID值,请参见如何获取实例ID。
|
DevEui | String | 是 | 0000000000000001 |
数据包所涉及的DevEUI,为16位HEX。 |
Base64EncodedMacPayload | String | 是 | SGVsbG8hIQ== |
Base64编码后的MACPayload报文,可调用ListNodeGroupTransferPackets接口查询获取。 |
LogMillis | Long | 是 | 1514736000000 |
数据包的发送时间,可调用ListNodeGroupTransferPackets接口查询获取。 |
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Success | Boolean | true |
是否调用成功。返回值:
|
RequestId | String | 89EF6CAA-958F-F32C-BE45-FE003C6DE097 |
阿里云为该请求生成的唯一标识符。 |
Data | Object |
调用成功时返回的数据包信息列表。 |
|
GwOwnerAliyunId | String | XXX |
数据包所经过网关所属用户的阿里云账号。 |
LogMillis | Long | 1514736000000 |
数据包传输的UNIX时间戳,以毫秒为单位。 |
ProcessEvent | String | SUCCESS |
该报文的处理结果。返回值:
|
Base64EncodedMacPayload | String | SGVsbG8hIQ== |
Base64编码后的MACPayload报文。 |
FPort | Integer | 99 |
收发此数据包时所使用的FPort。 |
Lsnr | Float | -10.5 |
收发此数据包的信噪比。 |
FreqBandPlanGroupId | Long | 101 |
数据包所经过的网关所采用的频段ID。 |
HasData | Boolean | true |
此数据包中是否包含业务数据。返回值:
|
ClassMode | String | C |
收发此数据包时的LoRaWAN Class模式。 |
MacPayloadSize | Integer | 15 |
此数据包的MACPayload报文长度。 |
MessageType | String | JOIN_REQUEST |
消息类型。返回值:
|
Datr | String | SF12BW125 |
收发此数据包的数据速率。 |
DevAddr | String | 00000000 |
收发此数据包的节点的网络地址。 |
DevEui | String | 0000000000000001 |
收发此数据包的节点的DevEUI。 |
GwEui | String | 0000000000000000 |
收发此数据包所经过的网关的GwEUI。 |
Rssi | Integer | -110 |
收发此数据包的RSSI。 |
HasMacCommand | Boolean | true |
此数据包中是否包含MAC指令。返回值:
|
Freq | Float | 470.3 |
收发此数据包的频点。 |
MacCommandCIDs | Array of Object | ["0x01","0x02"] |
这个数据包所携带的MAC指令列表。 |
示例
请求示例
http(s)://linkwan.cn-shanghai.aliyuncs.com/?Action=GetNodeTransferPacket
&IotInstanceId=iot-cn-0pp1n8t****
&DevEui=0000000000000001
&Base64EncodedMacPayload=SGVsbG8hIQ==
&LogMillis=1514736000000
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetNodeTransferPacketResponse>
<Success>true</Success>
<RequestId>89EF6CAA-958F-F32C-BE45-FE003C6DE097</RequestId>
<Data>
<GwOwnerAliyunId>XXX</GwOwnerAliyunId>
<LogMillis>1514736000000</LogMillis>
<ProcessEvent>SUCCESS</ProcessEvent>
<Base64EncodedMacPayload>SGVsbG8hIQ==</Base64EncodedMacPayload>
<FPort>99</FPort>
<Lsnr>-10.5</Lsnr>
<FreqBandPlanGroupId>101</FreqBandPlanGroupId>
<HasData>true</HasData>
<ClassMode>C</ClassMode>
<MacPayloadSize>15</MacPayloadSize>
<MessageType>JOIN_REQUEST</MessageType>
<Datr>SF12BW125</Datr>
<DevAddr>00000000</DevAddr>
<DevEui>0000000000000001</DevEui>
<GwEui>0000000000000000</GwEui>
<Rssi>-110</Rssi>
<HasMacCommand>true</HasMacCommand>
<Freq>470.3</Freq>
<MacCommandCIDs/>
</Data>
</GetNodeTransferPacketResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Success" : true,
"RequestId" : "89EF6CAA-958F-F32C-BE45-FE003C6DE097",
"Data" : {
"GwOwnerAliyunId" : "XXX",
"LogMillis" : 1514736000000,
"ProcessEvent" : "SUCCESS",
"Base64EncodedMacPayload" : "SGVsbG8hIQ==",
"FPort" : 99,
"Lsnr" : -10.5,
"FreqBandPlanGroupId" : 101,
"HasData" : true,
"ClassMode" : "C",
"MacPayloadSize" : 15,
"MessageType" : "JOIN_REQUEST",
"Datr" : "SF12BW125",
"DevAddr" : "00000000",
"DevEui" : "0000000000000001",
"GwEui" : "0000000000000000",
"Rssi" : -110,
"HasMacCommand" : true,
"Freq" : 470.3,
"MacCommandCIDs" : [ null ]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
400 | CloudProductNotActivated | The Link WAN service has not been activated. | 未开通 Link WAN 云产品 |
400 | FeatureNotActivated | The feature has not been activated. | 功能未开通 |
400 | ForbiddenByRam | User not authorized to operate on the specified resource, or this API does not support RAM. | 用户没有执行该操作所需要的RAM权限。 |
400 | ForbiddenByRiskControl | This operation cannot be performed because of security risks. | 存在安全风险,无法执行该操作 |
400 | NonExistent | The specified resource does not exist. | 要操作的资源不存在。 |
访问错误中心查看更多错误码。