Авторизация по API-токену

Каждая документированная операция требует авторизации. Передавайте токен из панели в заголовке Authorization:

Authorization: Bearer YOUR_API_TOKEN

Официальные SDK читают токен из серверного окружения и добавляют этот заголовок к каждому запросу:

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();

Создание и сброс токена

1. Войдите в панель LTESocks.
2. Откройте Settings → Profile.
3. Найдите блок API Token.
4. Создайте токен или сбросьте его при ротации.
5. Сразу скопируйте новое значение и сохраните как секрет.

Сброс делает прежнее значение недействительным. Обновите все серверные интеграции до ротации или сразу после нее.

Только серверное использование

Относитесь к токену как к паролю аккаунта:

• передавайте через переменную окружения или менеджер секретов;
• используйте HTTPS и проверяйте TLS-сертификаты;
• удаляйте Authorization из логов приложения и прокси;
• не публикуйте токен в клиентском JavaScript;
• используйте отдельный секрет для каждого окружения;
• ротируйте токен при подозрении на утечку.

Совместимость

В сервисе есть мост совместимости со старыми форматами токена. Новые интеграции должны всегда использовать документированный заголовок Bearer.

Ошибки авторизации

Отсутствующий, неверный, сброшенный или больше не активный токен приводит к неуспешному ответу. Считайте 401 постоянной ошибкой учетных данных: остановите повторы, уведомите оператора и замените секрет.