Життєвий цикл мобільного порту

Замовлення порту

Спочатку виберіть тариф і одну з його тарифікацій через GET /plans.

POST/ports/orderСтворити один мобільний проксі-порт

curl -X POST "https://api.ltesocks.io/v2/ports/order" \
  -H "Authorization: Bearer ${LTESOCKS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7c838e2d-7d52-42e7-aed1-528829cbd514" \
  -d '{
    "plan": "5349b4ddd2781d08c09890f3",
    "tarification": {
      "time": 2592000,
      "traffic": 51200,
      "price": 14500
    }
  }'

Офіційний SDK

const port = await client.ports.order({
  body: {
    plan: 'PLAN_ID',
    tarification: { time: 2_592_000, traffic: 51_200, price: 14_500 },
  },
});

console.log(port.port);

from ltesocks_sdk.models import OrderPortsBody, PlanTarification

port = client.ports.order(
    body=OrderPortsBody(
        plan="PLAN_ID",
        tarification=PlanTarification(
            time=2_592_000,
            traffic=51_200,
            price=14_500,
        ),
    )
)
print(port.port)

<?php

use LTESocks\Dto\OrderPortsRequest;
use LTESocks\Dto\PlanTarification;

$port = $client->ports()->order(new OrderPortsRequest([
    'plan' => 'PLAN_ID',
    'tarification' => new PlanTarification([
        'time' => 2592000,
        'traffic' => 51200,
        'price' => 14500,
    ]),
]));

echo $port->getPort();

Відповідь містить створений Port. Збережіть публічне значення port і використовуйте його як {id} у маршрутах портів. Створення може завершитися раніше, ніж проксі-підключення та IP будуть готові, тому перевірте повернутий порт і з’єднання до надсилання робочого трафіку.

Якщо замовлення завершилося таймаутом, повторіть точний запит із тим самим Idempotency-Key, а не надсилайте нове замовлення з новим ключем. Докладніше: Ідемпотентність і безпечні повтори та Скидання та готовність порту.

Перегляд і фільтрація

GET /ports повертає першу сторінку. Використовуйте POST /ports для фільтрів і пагінації:

{
  "plan": "O2",
  "countryCode": "GB",
  "tags": ["production"],
  "page": 1,
  "pageSize": 100
}

Офіційний SDK

const result = await client.ports.filter({
  body: {
    plan: 'PLAN_ID',
    countryCode: 'US',
    tags: ['Production1'],
    page: 1,
    pageSize: 100,
  },
});

from ltesocks_sdk.models import FilterPortsBody

result = client.ports.filter(
    body=FilterPortsBody(
        plan="PLAN_ID",
        country_code="US",
        tags=["Production1"],
        page=1,
        page_size=100,
    )
)

<?php

use LTESocks\Dto\FilterPortsRequest;

$result = $client->ports()->filter(new FilterPortsRequest([
    'plan' => 'PLAN_ID',
    'countryCode' => 'US',
    'tags' => ['Production1'],
    'page' => 1,
    'pageSize' => 100,
]));

Перегляд і зміна тарифу

GET /ports/{id} повертає один порт.
POST /ports/{id}/extend продовжує поточний тариф.
POST /ports/{id}/plan змінює тариф за допомогою ідентифікатора plan і об’єкта tarification.

Після кожної зміни прочитайте повернутий порт і оновіть збережені значення строку дії, трафіку та статусу.

Скидання та видалення

POST /ports/{id}/reset запитує скидання з’єднання та зміну IP. Успішна відповідь підтверджує запит, але не гарантує готовність нової IP-адреси. Ураховуйте cooldown і ознаки завершення з розділу Скидання та готовність порту.

DELETE /ports/{id} остаточно видаляє порт. POST /ports/{id}/delete існує як маршрут сумісності. Для нових інтеграцій використовуйте DELETE.