Поиск заказа (один)

Адрес API

GET /api/v1/frontend/order/query?serial={serial_no}

Параметры запроса

Название параметраТипОбязательноОписаниеПример
serialstringДаНомер заказа, возвращаемый при размещении заказа

Параметры ответа

  • Пример нормального ответа
{
    "errno": 0,
    "receive_address": "TExWKszFWYTKZH8LYiovAPKzS3L9MLZ4kw", 
    "order_no": "58b451473d290f92443eabf0322b9907", 
    "energy_amount": 32000, 
    "pay_amount": 0.0, 
    "amount": 3800000, 
    "details": [ // Заказы большого объема могут быть разбиты на несколько делегаций
        {
            "delegate_hash": "e2e71df638a9e01492a50bebba072a39eb75f673e91d5374ccf517f44e113f3",
            "delegate_time": "2023-10-09T10:21:07.840478Z",
            "reclaim_hash": "f4672a9563947cf78e5534b4025451dfd75efa5481a67b20ee55b9be368c900",
            "reclaim_time": "2023-10-12T10:21:07.840478Z",
            "reclaim_time_real": "2023-10-09T10:26:12.617456Z",
            "status": 30 // 20-В процессе делегации, 30-Восстановлено
        }
    ],
    "create_time": "2023-06-15T21:42:13.200565+08:00", 
    "api_name": "MY API", 
    "period": 0, 
    "status": 30, // 30 означает, что делегация полностью успешна
    "refund_amount": 0
}

  • Пример ошибки
{
    "errno": 404,
    "message": "Заказ не найден"
}
  • Пояснение полей
Название параметраТипОписаниеПример
receive_addressstringАдрес получения энергии
order_nostringНомер заказа, тот же, что и serial
energy_amountintКоличество энергии в заказе
pay_amountfloatДелегированная энергия
amountintОплаченная сумма в TRX, единица измерения sun
create_timestringВремя размещения заказа
api_namestringAPI, через который размещен заказ
periodintСрок аренды, в настоящее время поддерживаются
0 (1 час), 1 (1 день),
3 (3 дня), 30 (30 дней)
statusintСтатус заказа
(0, 'Закрыто по таймауту'),
(10, 'Ожидание оплаты'),
(20, 'Оплачено'),
(30, 'Подготовка делегации'),
(31, 'Частичная делегация'),
(32, 'Повторная попытка из-за ошибки'),
(40, 'Успешное завершение'),
(41, 'Возврат завершен'),
(43, 'Ошибка завершения'),
refund_amountintСумма возврата, единица измерения sun

Пример кода

import requests

API_KEY = "B433BFF1CDE7450AA38A56BEAC690DD4"
URL = "https://itrx.io/api/v1/frontend/order/query"
params = {'serial': '58b451473d290f92443eabf0322b9907'}
headers = {
    "API-KEY": API_KEY
}
response = requests.get(f"{URL}", params=params, headers=headers)
print(response.json())
<?php
$API_KEY = "B433BFF1CDE7450AA38A56BEAC690DD4";
$URL = "https://itrx.io/api/v1/frontend/order/query";
$params = array('serial' => '58b451473d290f92443eabf0322b9907');
$headers = array('API-KEY' => $API_KEY);

$context = stream_context_create(array(
    'http' => array(
        'method' => 'GET',
        'header' => "API-KEY: " . $API_KEY,
    )
));
$response = file_get_contents($URL . "?" . http_build_query($params), false, $context);

var_dump(json_decode($response, true));
?>

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

public class Main {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();
        String url = "https://itrx.io/api/v1/frontend/order/query?serial=58b451473d290f92443eabf0322b9907";
        Request request = new Request.Builder()
                .url(url)
                .addHeader("API-KEY", "B433BFF1CDE7450AA38A56BEAC690DD4")
                .build();
        try {
            Response response = client.newCall(request).execute();
            System.out.println(response.body().string());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

package main

import (
	"io/ioutil"
	"net/http"
	"fmt"
)

func main() {
	API_KEY := "B433BFF1CDE7450AA38A56BEAC690DD4"
	URL := "https://itrx.io/api/v1/frontend/order/query?serial=58b451473d290f92443eabf0322b9907"

	client := &http.Client{}
	req, _ := http.NewRequest("GET", URL, nil)
	req.Header.Set("API-KEY", API_KEY)

	resp, err := client.Do(req)
	if err != nil {
		fmt.Printf("The HTTP request failed with error %s\n", err)
	} else {
		data, _ := ioutil.ReadAll(resp.Body)
		fmt.Println(string(data))
	}
}

API_KEY="B433BFF1CDE7450AA38A56BEAC690DD4"
URL="https://itrx.io/api/v1/frontend/order/query"
params="serial=58b451473d290f92443eabf0322b9907"

curl -X GET -H "API-KEY:$API_KEY" "$URL?$params"

Last Updated: