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
}
}
Параметры ответа
Параметр | Тип | Описание |
---|---|---|
addresses | array | Массив всех адресов в Host Mode |
address | string | TRC-20 адрес |
status | integer | Статус адреса (1 = активен, 0 = остановлен) |
cycle_set | integer | Количество установленных циклов |
infinity_mode | boolean | Включен ли бесконечный режим |
created_at | string | Время добавления адреса |
updated_at | string | Время последнего обновления |
last_delegation | string/null | Время последней делегации энергии |
total_addresses | integer | Общее количество адресов |
active_addresses | integer | Количество активных адресов |
Ошибки
Ошибка аутентификации (401)
json
{
"code": -1,
"msg": "Invalid API key or IP not in whitelist",
"data": null
}
Примечания
- Эндпоинт возвращает все адреса в Host Mode для вашего аккаунта
- Адреса со статусом 0 остановлены и не получают энергию
- Infinity mode означает неограниченное количество циклов
- last_delegation показывает когда адрес последний раз получал энергию