API пакетов

Читайте свои безлимитные пакеты прокси и управляйте разрешёнными IP каждого пакета. Для записи нужен API-ключ Bearer; сессия документации, в которой вы вошли, может читать, но не писать. Каждая запись — один вызов: заголовка предусловия нет, и побеждает последняя успешная запись.

Список и чтение#

GET /api/v1/packages
GET /api/v1/packages/{packageId}
Authorization: Bearer lit_...

{
  "data": {
    "id": 45,
    "status": "active",
    "product": { "key": "dc-shared-rotating", "name": "DC Shared Rotating" },
    "country": "us",
    "quantity": 2,
    "addOns": ["high-speed"],
    "limits": { "speedMbps": 20, "connections": 300, "requestsPerSec": 25 },
    "renewsAt": "2027-01-01T00:00:00.000Z",
    "endsAt": null,
    "tokenIds": [12345, 12346]
  }
}

Неизвестный, чужой или не поддающийся разбору packageId даёт 404 PACKAGE_NOT_FOUND.

Статус#

product.key — ключ семейства в каталоге, а product.name — его отображаемое название. addOns перечисляет публичные названия дополнений: high-speed, more-allowed-ips, multi-location. limits — действующий для каждого токена предел скорости, числа соединений и частоты запросов для конфигурации этого пакета, либо null, если его не удалось определить. tokenIds перечисляет текущие токены пакета; читайте каждый через Токены.

Разрешённые IP#

Список разрешённых IP пакета позволяет принимать подключения без пароля с точных публичных исходных адресов IPv4. Он действует на каждый готовый эндпоинт прокси в пакете; каждый из этих токенов также сообщает собственный эндпоинт без пароля как ipAuth (см. Токены). Данные для подключения продолжают работать независимо от того, пуст список или нет. IPv6 не поддерживается; обратитесь в поддержку.

GET /api/v1/packages/{packageId}/allowed-ips
Authorization: Bearer lit_...

{
  "data": {
    "packageId": 45,
    "limit": 50,
    "ips": ["8.8.8.8", "9.9.9.9"],
    "available": true,
    "unavailableCode": null
  }
}

limit равен 1 для пакета без дополнения и 50 с more-allowed-ips. available: false означает, что сама функция разрешённых IP сейчас недоступна; unavailableCode тогда называет причину.

Изменение списка#

Задайте весь список сразу:

PUT /api/v1/packages/{packageId}/allowed-ips
Authorization: Bearer lit_...
Content-Type: application/json

{"ips": ["8.8.8.8", "9.9.9.9"]}

Всё или ничего: один некорректный IP отклоняет весь запрос с 400 INVALID_IP, где он назван, а список длиннее limit даёт 409 ALLOWED_IPS_LIMIT_REACHED. Чтобы очистить список, отправьте {"ips": []}.

Добавьте или удалите один IP, не читая список заранее:

PUT /api/v1/packages/{packageId}/allowed-ips/{ip}
DELETE /api/v1/packages/{packageId}/allowed-ips/{ip}
Authorization: Bearer lit_...

Ни один из этих запросов не принимает тело. Добавление IP, который уже в списке, или удаление отсутствующего — успешная операция без изменений. Удаление лишь помечает строку как отозванную, поэтому история аудита сохраняется; в ips она снова не появляется.

Каждая запись разрешённых IP возвращает ту же форму {data: ...}, что показана выше.

Безопасность и ограничения#

Добавление IP даёт доступ без пароля с этого источника ко всем готовым эндпоинтам пакета; удаление IP этот доступ отнимает. Записи в один пакет ограничены 20 за 60 секунд сверх ограничения на ключ; см. ограничения частоты запросов.

Ошибки разрешённых IP#

Каждый код описан на странице Ошибки API; схемы — в контракте OpenAPI.

Прокси «Мультилокация»#

Целевые город и оператор прокси «Мультилокация» — настройки токена, а не пакета: читайте и меняйте их через Токены: местоположение.