POST /apiv2/time/add

Добавление TRC-20 адреса в Host Mode для автоматического управления энергией.

URL эндпоинта

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

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

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

Тело запроса

{
    "address": "TExampleAddress1234567890123456789"
}

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

Параметр	Тип	Обязательный	Описание
address	string	Да	Валидный TRC-20 адрес (34 символа, начинается с T)

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

cURL

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

Python

import requests

url = "https://netts.io/apiv2/time/add"
headers = {"X-API-KEY": "your_api_key"}
data = {"address": "TExampleAddress1234567890123456789"}

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

if response.status_code == 200:
    print(f"Адрес добавлен в Host Mode: {result['data']['address']}")
else:
    print(f"Ошибка: {result.get('msg')}")

Node.js

const axios = require('axios');

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

async function addToHostMode() {
    try {
        const response = await axios.post(url, data, { headers });
        console.log(`Адрес добавлен: ${response.data.data.address}`);
    } catch (error) {
        console.error('Error:', error.response.data.msg);
    }
}

addToHostMode();

PHP

<?php
$url = 'https://netts.io/apiv2/time/add';
$headers = ['Content-Type: application/json', 'X-API-KEY: your_api_key'];
$data = json_encode(['address' => 'TExampleAddress1234567890123456789']);

$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, $data);

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

if ($httpCode == 200) {
    $result = json_decode($response, true);
    echo "Адрес добавлен: " . $result['data']['address'] . "\n";
} else {
    $error = json_decode($response, true);
    echo "Ошибка: " . $error['msg'] . "\n";
}
?>

Ответ

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

{
    "code": 0,
    "msg": "Address added to Host Mode successfully",
    "data": {
        "address": "TExampleAddress1234567890123456789",
        "timestamp": "2025-08-16T10:30:45.123456",
        "status": 1,
        "cycle_set": 0
    }
}

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

Параметр	Тип	Описание
address	string	Добавленный TRC-20 адрес
timestamp	string	Время добавления (ISO 8601)
status	integer	Статус адреса (1 = активен, 0 = неактивен)
cycle_set	integer	Количество установленных циклов

Ошибки

Неверный формат адреса (400)

{
    "code": -4,
    "msg": "Invalid TRC-20 address format",
    "data": null
}

Адрес уже существует (409)

{
    "code": -4,
    "msg": "This address is already managed in Host Mode",
    "data": {
        "address": "TExampleAddress1234567890123456789",
        "existing_since": "2025-08-15T14:20:30"
    }
}

Примечания

• Host Mode позволяет автоматически управлять энергией для указанных адресов
• После добавления адреса, вы можете заказывать для него циклы энергии
• Максимальное количество адресов в Host Mode зависит от типа вашего аккаунта
• Адрес должен быть активирован в сети TRON перед добавлением