API 开发者文档

概述

该 API 提供能量租赁服务,包括查询余额、支付能量费用以及获取能量单价的功能。所有请求和响应均使用 JSON 格式。

基本信息

请求参数

参数名 类型 描述
key string 用户的唯一 Key,32 位 MD5 字符串,严禁泄露
address string 接收地址,用于接收能量
nums int 能量数量(1: 65000 能量, 2: 131000 能量),只能选择 1 或 2,默认 1
action string 请求动作(可选值: pay, check_balance, get_price

可用动作及其说明

1. 下单能量 (pay)

请求方式: GET

选择语言并复制代码:


GET /api?action=pay&key=your_key&address=your_address&nums=1
        

成功响应示例:


{
  "code": 10000,
  "msg": "操作成功",
  "data": {
    "balance": 50.00, // 余额
    "orderId": "123456", // 订单号
    "orderMoney": 5.00, // 本次消耗金额
    "trxHash": "abc123", // trxHash 值
    "sendAddressList": ["address1", "address2"] // 发送能量的地址【这里不是你收的地址,是发送的地址】
  }
}
        

2. 查询余额 (check_balance)

请求方式: GET

选择语言并复制代码:


GET /api?action=check_balance&key=your_key
        

成功响应示例:


{
  "code": 10000,
  "msg": "查询余额成功",
  "data": {
    "balance": 50.00 // KEY 余额
  }
}
        

3. 获取能量单价 (get_price)

请求方式: GET

选择语言并复制代码:


GET /api?action=get_price
        

成功响应示例:


{
  "code": 10000,
  "msg": "单价查询成功",
  "data": {
    "price": 1.55 // 当前能量 65000 的 API 价格
  }
}
        

失败响应示例

错误码 描述 示例响应
40001 Key 不存在
{"code": 40001, "msg": "Key不存在"}
40002 用户不存在
{"code": 40002, "msg": "用户不存在"}
40003 余额不足
{"code": 40003, "msg": "余额不足", "data": {"balance": 50.00, "orderMoney": 5.00}}
40004 账户已冻结
{"code": 40004, "msg": "账户已冻结,请联系客服"}
50001 订单处理失败
{"code": 50001, "msg": "订单失败,联系客服!"}
500 服务器内部错误
{"code": 500, "msg": "数据库连接失败"}

注意事项

联系方式

如有问题、开户或充值需求,请点击联系开发者