Запити та локалізація

Стандартні заголовки

Accept: application/json
Accept-Language: en
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

Content-Type обов’язковий, якщо запит має JSON-тіло. Accept-Language необов’язковий; якщо заголовка немає, сервіс використовує en.

Мовний заголовок

Передавайте код мови, який підтримує API, наприклад en або ru. Middleware перевіряє вказану локаль, тому непідтримуване значення може завершити запит ще до виклику контролера. Українська локаль цього сайту не означає підтримку Accept-Language: uk самим API. Заголовок впливає на повідомлення сервісу, але не перейменовує ключі JSON.

Налаштуйте заголовок один раз під час створення клієнта офіційного SDK. Український приклад використовує en:

JavaScript

const client = LTESocksClient.withBearerToken(token, {
  language: 'en',
});

Python

client = Client.with_bearer_token(
    token,
    language="en",
)

PHP

<?php

$client = Client::builder()
    ->withBearerToken($token)
    ->withLanguage('en')
    ->build();

JSON-тіла

Передавайте коректний JSON у UTF-8 і використовуйте точні назви полів із довідника API. Не передавайте рядки замість логічних або цілих значень:

{
  "autoRenew": true,
  "autoResetInterval": 600
}

Значення часу

Фільтри дат використовують часові позначки у форматі RFC 3339. За можливості вказуйте часовий пояс явно:

{
  "from": "2026-07-01T00:00:00Z",
  "to": "2026-07-31T23:59:59Z",
  "page": 1,
  "pageSize": 20
}

Задавайте скінченний клієнтський таймаут. Загальний таймаут у 30 секунд є розумним початковим значенням для JSON-операцій; для завантаження VPN-архівів може знадобитися окремий таймаут.