Решение проблем

API отклоняет токен

• Убедитесь, что заголовок начинается с Bearer и не содержит кавычек.
• Проверьте, что секрет относится к нужному аккаунту LTESocks.
• Если токен сбрасывали в панели, замените каждую развернутую копию.
• Проверьте его безопасной операцией GET /user.

Эквивалентный диагностический запрос через официальный SDK:

JavaScript

import { LTESocksClient } from '@ltesocks/sdk';

const client = LTESocksClient.withBearerToken(
  process.env.LTESOCKS_API_TOKEN,
  { language: 'ru' },
);
const user = await client.user.get();

console.log(user.login);

Python

import os

from ltesocks_sdk import Client

with Client.with_bearer_token(
    os.environ["LTESOCKS_API_TOKEN"],
    language="ru",
) as client:
    user = client.user.get()
    print(user.login)

PHP

<?php

use LTESocks\Client;

require __DIR__ . '/vendor/autoload.php';

$client = Client::builder()
    ->withBearerToken((string) getenv('LTESOCKS_API_TOKEN'))
    ->withLanguage('ru')
    ->build();
$user = $client->user()->get();

echo $user->getLogin();

Запрос отклоняется до операции

Удалите Accept-Language или укажите поддерживаемую локаль, например en или ru. Проверьте Content-Type: application/json и синтаксис JSON.

Порт не найден

Идентификаторы портов относятся к авторизованному аккаунту. Получите список портов этого аккаунта и передайте точное значение Port.port как {id}. Не передавайте внутренний ObjectID, ID услуги, reset-токен или идентификатор тарифа. resetToken используется только в GET /tokens/{token}.

Сброс отклонен или кажется зависшим

• Оставляйте не меньше 60 секунд между пользовательскими сбросами; пул порта может требовать более долгого cooldown.
• Если присутствуют Retry-After и Retry-At, соблюдайте их вместо немедленного повтора.
• Считайте HTTP 200 подтверждением запроса, а не завершением смены IP.
• Сравнивайте поле ip порта или обрабатывайте вебхук port.ip_changed; запись в журнале подтверждает только регистрацию действия.

Полная последовательность описана в разделе Сброс и готовность порта.

Приходит 429

Уменьшите параллельность, используйте страницы большего размера и повторяйте с экспоненциальной задержкой и jitter. Лимит изменяющих методов ниже лимита GET.

VPN-ответ не разбирается

VPN-операции возвращают бинарный архив. Не вызывайте response.json(). Потоково сохраните тело в защищенный файл, проверьте статус и Content-Type, затем проверьте архив.

Изменяющий запрос завершился по таймауту

Для операций с поддержкой Idempotency-Key повторите точный запрос с тем же ключом. В остальных случаях не повторяйте сразу: прочитайте состояние порта или историю платежей, чтобы определить результат первой попытки. Не создавайте новый ключ только потому, что первый ответ был потерян.

Список поддерживаемых операций приведен на странице Идемпотентность и безопасные повторы.

Для поддержки подготовьте время UTC, метод, шаблон пути, HTTP-статус и очищенный ответ. Не отправляйте bearer-токен, полные учетные данные или VPN-архив.