POST /apiv2/userinfo

Получение информации о пользователе, включая баланс и статистику использования.

URL эндпоинта

POST https://netts.io/apiv2/userinfo

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

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

Тело запроса

{}

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

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

cURL

curl -X POST https://netts.io/apiv2/userinfo \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{}'

Python

import requests
import json

url = "https://netts.io/apiv2/userinfo"
headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip"
}

response = requests.post(url, headers=headers, json={})
data = response.json()
print(json.dumps(data, indent=2))

Node.js

const axios = require('axios');

const url = 'https://netts.io/apiv2/userinfo';
const headers = {
    'Content-Type': 'application/json',
    'X-API-KEY': 'your_api_key',
    'X-Real-IP': 'your_whitelisted_ip'
};

async function getUserInfo() {
    try {
        const response = await axios.post(url, {}, { headers });
        console.log(response.data);
    } catch (error) {
        console.error('Error:', error.response.data);
    }
}

getUserInfo();

PHP

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

$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) {
    $data = json_decode($response, true);
    print_r($data);
} else {
    echo "Error: HTTP $httpCode\n";
    echo $response;
}
?>

Ответ

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

{
    "code": 0,
    "msg": "Success",
    "data": {
        "user_id": 12345,
        "email": "[email protected]",
        "balance": "1500.50",
        "total_orders": 42,
        "total_energy_delegated": 5502000,
        "total_trx_spent": "235.75",
        "save_by_netts_percent": 28.45,
        "save_in_dollars": 12.35
    }
}

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

Параметр	Тип	Описание
user_id	integer	ID пользователя
email	string	Email адрес
balance	string	Текущий баланс в TRX
total_orders	integer	Общее количество заказов
total_energy_delegated	integer	Общее количество делегированной энергии
total_trx_spent	string	Общая сумма потраченных TRX
save_by_netts_percent	float	Процент экономии с NETTS
save_in_dollars	float	Экономия в долларах США

Ошибки

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

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

IP не в белом списке (403)

{
    "code": -2,
    "msg": "Your IP address is not whitelisted",
    "data": null
}

Внутренняя ошибка сервера (500)

{
    "code": -1,
    "msg": "Database error",
    "data": null
}

Примечания

• Все суммы в TRX возвращаются как строки для сохранения точности
• IP адрес должен быть добавлен в белый список в личном кабинете
• Максимум 60 запросов в минуту на один API ключ