Купить энергию

Создать заказ

post

Query parameters

quantityinteger · int32Optional

Энергетическое число агента, минимум 65000, количество и счетчик должны быть переданы по одному.

countinteger · int32Optional

Что касается количества транзакций, необходимых для перевода USDT, если у другой стороны есть USDT, передайте 1, если у другой стороны нет USDT, передайте 2. Вы также можете передать число больше 2. Необходимо передать одно количество и один счетчик.

target_addressstringRequired

получающий энергетический адрес

periodinteger · int32Required

Период агента, возможные значения: 0, 1, 2, 3, 4...30. Среди них 0: быстрая зарядка; 1: один час; 3: 3 дня; 4: 4 дня... до 30 дней.

Header parameters

MF-ACCESS-KEYstringRequired

Чтобы получить КЛЮЧ, используемый API, свяжитесь с @mefreenet.

MF-ACCESS-TIMESTAMPstringRequired

Время инициирования запроса (UTC), например：2020-12-08T09:08:57.715Z。

MF-ACCESS-SIGNstringRequired

Хэш-значение получается с использованием хеш-функции HMAC SHA256, а затем кодируется в Base-64 (см. подпись).

Responses

200

*/*

post

POST /api/order HTTP/1.1
Host: api.mefree.net
MF-ACCESS-KEY: text
MF-ACCESS-TIMESTAMP: text
MF-ACCESS-SIGN: text
Accept: */*

200

{
  "code": 1,
  "msg": "text",
  "sub_code": "text",
  "sub_msg": "text",
  "data": {
    "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)

При создании заказа через API Mefree.net, важно обратить внимание на три ключевых параметра в ответе API:

pay_hash (хэш платежа/ID заказа) Уникальный идентификатор для каждого заказа. С его помощью можно запросить подробную информацию о заказе через интерфейс GET /order/{pay_hash}.
status (статус заказа) Показывает прогресс выполнения заказа. Если статус DELEGATE_SUCCESS, это значит, что сделка по энергии была успешно отправлена в блокчейн Tron. ⚠️ Примечание: существует небольшая вероятность (примерно 0.1%), что транзакция не попадёт в блокчейн.
confirm_status (статус подтверждения на блокчейне) Отражает, была ли энергия успешно отправлена на целевой адрес. Если confirm_status = DELEGATION_CONFIRMED, это значит, что энергия была успешно подтверждена и отправлена в блокчейне.

Как убедиться, что энергия отправлена на целевой адрес?

Используйте два способа проверки:

Запрос к API блокчейна Tron для проверки баланса энергии на целевом адресе. Используйте Tron API или инструменты кошелька (например, TronLink) для проверки энергии на целевом адресе.
Пример запроса к официальному API Tron:
```
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.
Запрос статуса заказа через GET /order/{pay_hash}. Если confirm_status = DELEGATION_CONFIRMED, это значит, что энергия была успешно отправлена и подтверждена на блокчейне.

Пример процесса работы

1. Создание заказа

Пример запроса:

POST /order?count=1&target_address=TRON_ADDRESS&period=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, энергия успешно отправлена.
Для дополнительной проверки вы можете запросить баланс энергии на целевом адресе через Tron API.

Часто задаваемые вопросы

Почему статус заказа DELEGATE_SUCCESS, но энергия не поступила?

Причина: Транзакция могла не попасть в блокчейн (вероятность около 0.1%).

Решение:

Подождите некоторое время и снова запросите статус заказа.
Проверьте транзакцию в блокчейне Tron с помощью соответствующего API.

Почему задерживается зачисление энергии?

Причина: Сеть блокчейна может быть перегружена.

Решение:

Убедитесь, что статус заказа DELEGATION_CONFIRMED, после чего энергия считается зачисленной.

Советы для надежной работы

Обращайте внимание на поля pay_hash и confirm_status, чтобы отслеживать статус заказов.
При необходимости проверяйте баланс целевого адреса через Tron API.

Если у вас возникают вопросы или сложности, свяжитесь с технической поддержкой Mefree через Telegram: @mefreenet.

PreviousИнформация об аккаунте NextДетали заказа

Last updated 6 months ago