购买能量

购买能量

创建订单

post

Query parameters

quantityinteger · int32Optional

代理的能量数,最小65000,quantity和count必须传一个。

countinteger · int32Optional

针对转USDT所需要的笔数,对方有USDT传1，对方无USDT传2，也可传大于2的数,quantity和count必须传一个。

target_addressstringRequired

代理的目标地址 the receiving energy address

periodinteger · int32Required

代理的周期,值可能为：0,1，2，3，4...30。其中0:速充；1:一小时;2:1天;3:3天;4:4天...最多30天。

client_order_idstringOptional

客户自定义订单ID（长度小于等于64），保持唯一性，传入之前的客户订单号，将不创建新订单

Header parameters

MF-ACCESS-KEYstringRequired

API所使用的KEY,请联系@mefreenet获取。

MF-ACCESS-TIMESTAMPstringRequired

发起请求的时间（UTC），如：2020-12-08T09:08:57.715Z。

MF-ACCESS-SIGNstringRequired

使用HMAC SHA256哈希函数获得哈希值，再使用Base-64编码（请参阅签名）。

Responses

200

OK

*/*

post

/api/order

HTTPcURLJavaScriptPython

POST /api/order?target_address=text&period=1 HTTP/1.1
Host: api.mefree.net
MF-ACCESS-KEY: text
MF-ACCESS-TIMESTAMP: text
MF-ACCESS-SIGN: text
Accept: */*

200

OK

{
  "code": 1,
  "msg": "text",
  "sub_code": "text",
  "sub_msg": "text",
  "data": {
    "client_order_id": "text",
    "pay_hash": "text",
    "timestamp": 1,
    "pay_address": "text",
    "delegate_hash": "text",
    "amount_sun": 1,
    "energy_to_address": "text",
    "energy_quantity": 1,
    "energy_period": 1,
    "energy_expired_timestamp": 1,
    "status": "TRANSFER_SUCCESS",
    "confirm_status": "UNCONFIRMED",
    "activate_status": "DEACTIVATE",
    "balance": 1
  }
}

核心 API：创建订单（POST /order）

在通过 Mefree.net 的 API 创建订单时，需要特别关注以下三个返回值：

1. pay_hash（支付哈希/订单 ID）：

   • 每个订单的唯一标识符。

   • 可通过 GET /order/{pay_hash} 接口查询该订单的详细信息。

2. status（订单状态）：

   • 反映订单的执行进度。

   • 当 status 为 DELEGATE_SUCCESS 时，表示能量交易已成功提交到波场区块链。

   • 注意：存在极小概率（约 0.1%）交易未能上链的情况。

3. confirm_status（链上确认状态）：

   • 确认能量是否已成功发送至目标地址。

   • 当 confirm_status 为 DELEGATION_CONFIRMED 时，表示能量已成功发送并在链上确认。

---

Q：如何保证能量已发送到目标地址？

您可以通过以下两种方式确认能量已发送成功：

1. 通过波场 API 查询目标地址的能量余额：

   • 使用波场官方 API 或钱包工具（如 TronLink）查询目标地址的能量余额。

   • 示例 API 请求（波场官方接口）：

     curl --request POST \
          --url https://api.trongrid.io/wallet/getaccountresource \
          --header 'accept: application/json' \
          --header 'content-type: application/json' \
          --data '
     {
       "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
       "visible": true
     }
     '

     在返回的响应中查看能量相关字段，如 energy_limit 和 energy_used 字段。

2. 查询订单的 confirm_status：

   • 使用 GET /order/{pay_hash} 接口查询订单详情。

   • 如果 confirm_status 为 DELEGATION_CONFIRMED，表示能量交易已成功在链上确认，目标地址已收到能量。

---

操作流程示例

1. 创建订单

请求示例：

POST /order?count=1&target_address=TRON_ADDRESS&peroid=1
Host: https://api.mefree.net
Headers: 
  Content-Type: application/json
  MF-ACCESS-KEY: {api_key}
  MF-ACCESS-SIGN: {signature}
  MF-ACCESS-TIMESTAMP: {timestamp}

响应示例：

{
  "pay_hash": "abcd1234",
  "status": "DELEGATE_SUCCESS",
  "confirm_status": "UNCONFIRMED"
}

---

2. 查询订单状态

请求示例：

GET /order/abcd1234
Host: https://api.mefree.net
Headers: 
  Content-Type: application/json
  MF-ACCESS-KEY: {api_key}
  MF-ACCESS-SIGN: {signature}
  MF-ACCESS-TIMESTAMP: {timestamp}

响应示例：

{
  "pay_hash": "abcd1234",
  "status": "DELEGATE_SUCCESS",
  "confirm_status": "DELEGATION_CONFIRMED"
}

---

3. 确认能量是否发送成功

• 如果 confirm_status 为 DELEGATION_CONFIRMED，说明能量已发送成功。

• 您也可以通过波场 API 查询目标地址的能量余额，以进一步验证。

---

常见问题说明

1. 订单状态为 DELEGATE_SUCCESS 但能量未到账？

   • 原因：可能交易未能上链（概率约为 0.1%）。

   • 解决方案：稍等一段时间后查询订单状态或通过波场区块链查看交易详情。

2. 能量到账延迟问题？

   • 原因：可能与区块链网络拥堵有关。

   • 解决方案：确保订单状态为 DELEGATION_CONFIRMED 后即可确认能量已到账。

---

通过关注订单的 pay_hash 和 confirm_status，以及链上验证方法，您可以确保能量交易的可靠性。如果仍有问题，可联系 Mefree 客服(@mefreenet)获取支持。