Быстрый старт

API доступен по адресу:

https://api.ltesocks.io/v2

Для всех публичных операций нужен API-токен. Создайте его в разделе Панель → Settings → Profile → API Token, затем поместите в менеджер секретов или переменную окружения.

export LTESOCKS_API_TOKEN="replace-with-your-token"

Защитите токен

Токен открывает доступ к ресурсам аккаунта. Не помещайте его в браузерный код, мобильные приложения, URL, снимки экрана или репозиторий.

cURL

curl --request GET \
  --url "https://api.ltesocks.io/v2/user" \
  --header "Accept: application/json" \
  --header "Accept-Language: ru" \
  --header "Authorization: Bearer ${LTESOCKS_API_TOKEN}"

JavaScript

const response = await fetch('https://api.ltesocks.io/v2/user', {
  headers: {
    Accept: 'application/json',
    'Accept-Language': 'ru',
    Authorization: `Bearer ${process.env.LTESOCKS_API_TOKEN}`,
  },
});

if (!response.ok) {
  const problem = await response.json();
  throw new Error(problem.error ?? `HTTP ${response.status}`);
}

const user = await response.json();
console.log(user.login);

Python

import os
import requests

response = requests.get(
    "https://api.ltesocks.io/v2/user",
    headers={
        "Accept": "application/json",
        "Accept-Language": "ru",
        "Authorization": f"Bearer {os.environ['LTESOCKS_API_TOKEN']}",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json()["login"])

PHP

<?php

$token = getenv('LTESOCKS_API_TOKEN');
$request = curl_init('https://api.ltesocks.io/v2/user');

curl_setopt_array($request, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Accept-Language: ru',
        "Authorization: Bearer {$token}",
    ],
    CURLOPT_TIMEOUT => 30,
]);

$body = curl_exec($request);
$status = curl_getinfo($request, CURLINFO_RESPONSE_CODE);
curl_close($request);

if ($status < 200 || $status >= 300) {
    throw new RuntimeException("LTESocks API вернул HTTP {$status}: {$body}");
}

$user = json_decode($body, true, flags: JSON_THROW_ON_ERROR);
echo $user['login'];

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

Установите один из официальных SDK, чтобы авторизация, типизированные модели, ошибки, идемпотентность, пагинация и загрузки обрабатывались одним поддерживаемым клиентом. Аналог запросов выше через 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();

Дальнейшие шаги

• Прочитайте про авторизацию до размещения токена в production.
• Выберите и установите официальный SDK.
• Изучите правила запросов и ответов.
• Получите тарифы, серверы и сигнатуры.
• Пройдите жизненный цикл мобильного порта.