查询能量值购买结果

生产环境

GET

/v3/orders/{operation_id}

AVATA API 文档/AVATA API 文档/AVATA v3 API 文档/购买能量值接口

根据指定的 OperationID，查询相关的订单信息。

当前支持查询当月及上个月的购买结果，其它月历史数据已归档，暂不支持查询对应结果。

注意：

若查询出的订单状态 status 为 3（充值失败），说明该交易执行失败。请在业务侧做容错处理。可以参考接口返回的 message（订单失败的错误描述信息）对业务接口的请求参数做适当调整后，使用「新的 Operation ID 」重新发起业务接口请求。

请求参数

Path 参数

operation_id

string

操作id

必需

Header 参数

Content-Type

string

必需

固定值：application/json

X-Api-Key

string

必需

项目 API Key，用于 API 访问鉴权

X-Timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

X-Signature

string

必需

API 签名，算法为SHA256(Params+Timestamp+ApiSecret)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://apis.avata.bianjie.ai/v3/orders/' \
--header 'X-Api-Key;' \
--header 'X-Api-Key;' \
--header 'X-Timestamp;' \
--header 'X-Timestamp;' \
--header 'X-Signature;' \
--header 'X-Signature;'

返回响应

🟢200successful operation

application/json

Body

data

object

必需

operation_id

string

必需

操作 ID，保证幂等性，避免重复请求，保证对于同一操作发起的一次请求或者多次请求的结果是一致的；由接入方生成并自行维护、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串组成。

status

enum<integer>

必需

订单状态：1 正在充值；2 充值成功；3 充值失败；订单状态说明： status 为 1（正在充值），请等待充值完成； status 为 2（充值成功），能量值/业务费充值成功； status 为 3（充值失败），说明该交易执行失败。请在业务侧做容错处理。可以参考接口返回的 message（订单失败的错误描述信息）对业务接口的请求参数做适当调整后，使用「新的 Operation ID 」重新发起业务接口请求。

枚举值:

123

message

string

必需

订单失败的错误描述信息

account

string

必需

链账户地址（调用「批量购买能量值」接口不展示此字段）

amount

string

必需

充值金额，为整数元金额；单位：分（调用「批量购买能量值」接口不展示此字段）

number

string

必需

充值的数量，充值 gas 该值单位为 ugas （调用「批量购买能量值」接口不展示此字段）

create_time

string

必需

创建时间（UTC 时间）

update_time

string

必需

最后操作时间（UTC 时间）

order_type

integer

必需

订单类型 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
  }
}

修改于 2023-08-07 09:37:08

批量购买能量值

查询能量值购买结果列表