购买能量
购买能量
代理的能量数,最小65000,quantity和count必须传一个。
针对转USDT所需要的笔数,对方有USDT传1,对方无USDT传2,也可传大于2的数,quantity和count必须传一个。
代理的目标地址 the receiving energy address
代理的周期,值可能为:0,1,2,3,4...30。其中0:速充;1:一小时;2:1天;3:3天;4:4天...最多30天。
客户自定义订单ID(长度小于等于64),保持唯一性,传入之前的客户订单号,将不创建新订单
API所使用的KEY,请联系@mefreenet获取。
发起请求的时间(UTC),如:2020-12-08T09:08:57.715Z。
使用HMAC SHA256哈希函数获得哈希值,再使用Base-64编码(请参阅签名)。
POST /api/order HTTP/1.1
Host: api.mefree.net
MF-ACCESS-KEY: text
MF-ACCESS-TIMESTAMP: text
MF-ACCESS-SIGN: text
Accept: */*
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 创建订单时,需要特别关注以下三个返回值:
pay_hash
(支付哈希/订单 ID):每个订单的唯一标识符。
可通过 GET
/order/{pay_hash}
接口查询该订单的详细信息。
status
(订单状态):反映订单的执行进度。
当
status
为DELEGATE_SUCCESS
时,表示能量交易已成功提交到波场区块链。注意:存在极小概率(约 0.1%)交易未能上链的情况。
confirm_status
(链上确认状态):确认能量是否已成功发送至目标地址。
当
confirm_status
为DELEGATION_CONFIRMED
时,表示能量已成功发送并在链上确认。
Q:如何保证能量已发送到目标地址?
您可以通过以下两种方式确认能量已发送成功:
通过波场 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
字段。
查询订单的
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 查询目标地址的能量余额,以进一步验证。
常见问题说明
订单状态为
DELEGATE_SUCCESS
但能量未到账?原因:可能交易未能上链(概率约为 0.1%)。
解决方案:稍等一段时间后查询订单状态或通过波场区块链查看交易详情。
能量到账延迟问题?
原因:可能与区块链网络拥堵有关。
解决方案:确保订单状态为
DELEGATION_CONFIRMED
后即可确认能量已到账。
通过关注订单的 pay_hash
和 confirm_status
,以及链上验证方法,您可以确保能量交易的可靠性。如果仍有问题,可联系 Mefree 客服(@mefreenet)获取支持。
Last updated