查询能量值购买结果
GET
/v3/orders/{operation_id}根据指定的 OperationID,查询相关的订单信息。
当前支持查询当月及上个月的购买结果,其它月历史数据已归档,暂不支持查询对应结果。
注意:
若查询出的订单状态 status 为 3(充值失败),说明该交易执行失败。请在业务侧做容错处理。可以参考接口返回的 message(订单失败的错误描述信息) 对业务接口的请求参数做适当调整后,使用「新的 Operation ID 」重新发起业务接口请求。
请求参数
固定值:application/json
项目 API Key,用于 API 访问鉴权
时间戳,1970年1月1日0点0分0秒到现在的毫秒数
API 签名,算法为SHA256(Params+Timestamp+ApiSecret)
示例代码
返回响应
操作 ID,保证幂等性,避免重复请求,保证对于同一操作发起的一次请求或者多次请求的结果是一致的;由接入方生成并自行维护、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串组成。
订单状态:1 正在充值;2 充值成功;3 充值失败; 订单状态说明: status 为 1(正在充值),请等待充值完成; status 为 2(充值成功),能量值/业务费充值成功; status 为 3(充值失败),说明该交易执行失败。请在业务侧做容错处理。可以参考接口返回的 message(订单失败的错误描述信息) 对业务接口的请求参数做适当调整后,使用「新的 Operation ID 」重新发起业务接口请求。
订单失败的错误描述信息
链账户地址 (调用「批量购买能量值」接口不展示此字段)
充值金额,为整数元金额;单位:分 (调用「批量购买能量值」接口不展示此字段)
充值的数量,充值 gas 该值单位为 ugas (调用「批量购买能量值」接口不展示此字段)
创建时间(UTC 时间)
最后操作时间(UTC 时间)
订单类型 1 gas,能量值;
{
"data": {
"operation_id": "string",
"status": 1,
"message": "string",
"account": "string",
"amount": "string",
"number": "string",
"create_time": "string",
"update_time": "string",
"order_type": 0
}
}