Skip to content

POST /apiv2/time/status

Получение детального статуса всех адресов в Host Mode.

URL эндпоинта

POST https://netts.io/apiv2/time/status

Заголовки запроса

ЗаголовокОбязательныйОписание
Content-TypeДаapplication/json
X-API-KEYДаВаш API ключ

Тело запроса

json
{}

Запрос не требует параметров в теле.

Примеры запросов

cURL

bash
curl -X POST https://netts.io/apiv2/time/status \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{}'

Python

python
import requests

url = "https://netts.io/apiv2/time/status"
headers = {"X-API-KEY": "your_api_key"}

response = requests.post(url, headers=headers, json={})
result = response.json()

if response.status_code == 200:
    addresses = result['data']['addresses']
    print(f"Всего адресов в Host Mode: {result['data']['total_addresses']}")
    for addr in addresses:
        print(f"Адрес: {addr['address']}")
        print(f"Статус: {'Активен' if addr['status'] == 1 else 'Неактивен'}")
        print(f"Циклы: {addr['cycle_set']}")
        print("---")
else:
    print(f"Ошибка: {result.get('msg')}")

Node.js

javascript
const axios = require('axios');

const url = 'https://netts.io/apiv2/time/status';
const headers = {'X-API-KEY': 'your_api_key'};

async function getHostModeStatus() {
    try {
        const response = await axios.post(url, {}, { headers });
        const data = response.data.data;
        
        console.log(`Всего адресов: ${data.total_addresses}`);
        data.addresses.forEach(addr => {
            console.log(`${addr.address}: ${addr.status ? 'Активен' : 'Неактивен'} (${addr.cycle_set} циклов)`);
        });
    } catch (error) {
        console.error('Error:', error.response.data.msg);
    }
}

getHostModeStatus();

PHP

php
<?php
$url = 'https://netts.io/apiv2/time/status';
$headers = ['Content-Type: application/json', 'X-API-KEY: your_api_key'];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{}');

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode == 200) {
    $result = json_decode($response, true);
    $data = $result['data'];
    
    echo "Всего адресов: " . $data['total_addresses'] . "\n";
    foreach ($data['addresses'] as $addr) {
        $status = $addr['status'] ? 'Активен' : 'Неактивен';
        echo $addr['address'] . ": $status (" . $addr['cycle_set'] . " циклов)\n";
    }
} else {
    $error = json_decode($response, true);
    echo "Ошибка: " . $error['msg'] . "\n";
}
?>

Ответ

Успешный ответ (200 OK)

json
{
    "code": 0,
    "msg": "Success",
    "data": {
        "addresses": [
            {
                "address": "TExampleAddress1234567890123456789",
                "status": 1,
                "cycle_set": 5,
                "infinity_mode": false,
                "created_at": "2025-08-15T14:20:30",
                "updated_at": "2025-08-16T10:30:45",
                "last_delegation": "2025-08-16T09:15:22"
            },
            {
                "address": "TAnotherExampleAddress123456789012",
                "status": 0,
                "cycle_set": 0,
                "infinity_mode": true,
                "created_at": "2025-08-14T08:10:15",
                "updated_at": "2025-08-16T10:30:45",
                "last_delegation": null
            }
        ],
        "total_addresses": 2,
        "active_addresses": 1
    }
}

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

ПараметрТипОписание
addressesarrayМассив всех адресов в Host Mode
addressstringTRC-20 адрес
statusintegerСтатус адреса (1 = активен, 0 = остановлен)
cycle_setintegerКоличество установленных циклов
infinity_modebooleanВключен ли бесконечный режим
created_atstringВремя добавления адреса
updated_atstringВремя последнего обновления
last_delegationstring/nullВремя последней делегации энергии
total_addressesintegerОбщее количество адресов
active_addressesintegerКоличество активных адресов

Ошибки

Ошибка аутентификации (401)

json
{
    "code": -1,
    "msg": "Invalid API key or IP not in whitelist",
    "data": null
}

Примечания

  • Эндпоинт возвращает все адреса в Host Mode для вашего аккаунта
  • Адреса со статусом 0 остановлены и не получают энергию
  • Infinity mode означает неограниченное количество циклов
  • last_delegation показывает когда адрес последний раз получал энергию