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

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

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

OK

*/*

codeinteger · int32Optional

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

msgstringOptional

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

sub_codestringOptional

sub_msgstringOptional

post/api/order

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": {
    "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:

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.