Швидкий старт

API доступний за адресою:

https://api.ltesocks.io/v2

Для всіх публічних операцій потрібен API-токен. Створіть його в розділі Dashboard → 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: en" \
  --header "Authorization: Bearer ${LTESOCKS_API_TOKEN}"

JavaScript

const response = await fetch('https://api.ltesocks.io/v2/user', {
  headers: {
    Accept: 'application/json',
    'Accept-Language': 'en',
    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": "en",
        "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: en',
        "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 returned 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: 'en' },
);
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="en",
) 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('en')
    ->build();
$user = $client->user()->get();

echo $user->getLogin();

Подальші кроки

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