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

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

POSThttps://api.mefree.net/api/order

Query parameters

Header parameters

Response

200

OK

Body

*/*

codeinteger (int32)

Возвращает 0 успешно, остальные — ошибки.

msgstring

Сообщение, возвращаемое при возникновении ошибки

sub_codestring

sub_msgstring

dataAPIDelegateResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.mefree.net/api/order?target_address=text&period=0', {
    method: 'POST',
    headers: {
      "MF-ACCESS-KEY": "text",
      "MF-ACCESS-TIMESTAMP": "text",
      "MF-ACCESS-SIGN": "text"
    },
});
const data = await response.json();

Response

200

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

Основной API: Создание заказа (POST /order)

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

1. pay_hash (хэш платежа/ID заказа) Уникальный идентификатор для каждого заказа. С его помощью можно запросить подробную информацию о заказе через интерфейс GET /order/{pay_hash}.

2. status (статус заказа) Показывает прогресс выполнения заказа. Если статус DELEGATE_SUCCESS, это значит, что сделка по энергии была успешно отправлена в блокчейн Tron. ⚠️ Примечание: существует небольшая вероятность (примерно 0.1%), что транзакция не попадёт в блокчейн.

3. confirm_status (статус подтверждения на блокчейне) Отражает, была ли энергия успешно отправлена на целевой адрес. Если confirm_status = DELEGATION_CONFIRMED, это значит, что энергия была успешно подтверждена и отправлена в блокчейне.

---

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

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

1. Запрос к 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.

2. Запрос статуса заказа через 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.