Официальные SDK

Официальные SDK предоставляют те же аутентифицированные операции API v2 в виде типизированных методов ресурсов. Используйте их в доверенных серверных приложениях и никогда не передавайте API-токен аккаунта в браузерный код.

SDK	Среда выполнения	Пакет	Исходный код
JavaScript / TypeScript	Node.js 22 или новее	@ltesocks/sdk	GitHub
Python	Python 3.11 или новее	ltesocks-sdk	GitHub
PHP	PHP 8.3 или новее	ltesocks/php-sdk	GitHub

Установка

Выберите язык. Выбор сохранится для всех примеров SDK на этом сайте.

JavaScript

# npm
npm install @ltesocks/sdk

# pnpm
pnpm add @ltesocks/sdk

# Yarn
yarn add @ltesocks/sdk

Python

pip install ltesocks-sdk

PHP

composer require ltesocks/php-sdk

Создание клиента

Задайте LTESOCKS_API_TOKEN в переменной окружения процесса, затем создайте клиент. Базовый production URL и заголовок авторизации настраиваются автоматически.

JavaScript

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

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

Python

import os

from ltesocks_sdk import Client

client = Client.with_bearer_token(
    os.environ["LTESOCKS_API_TOKEN"],
    language="ru",
)

PHP

<?php

use LTESocks\Client;

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

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

Синхронный и асинхронный Python

Для краткости примеры в документации используют синхронный Client. В приложениях с асинхронным циклом событий используйте AsyncClient с теми же именами ресурсов и ожидайте каждую операцию:

import os

from ltesocks_sdk import AsyncClient

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

Поведение клиента

• Каждый SDK по умолчанию обращается к https://api.ltesocks.io/v2 и отправляет Accept-Language.
• Типизированные ресурсы покрывают пользователя, порты, платежи, тарифы, серверы и сигнатуры.
• Поддерживаемые мутации автоматически получают ключ идемпотентности. Транспортный сбой без HTTP-ответа можно повторить с тем же ключом; ответы с HTTP-ошибкой автоматически не повторяются.
• Классы ошибок сохраняют статус, детали ответа, время допустимого повтора, заголовки и ключ идемпотентности запроса, если он доступен.
• Метод сырого запроса позволяет временно вызвать новый endpoint до регенерации SDK.

Фиксируйте версию SDK в production и проверяйте changelog перед обновлением. Контракт OpenAPI остаётся источником истины по endpoint и моделям.

Продолжите с быстрого старта или первого запроса.