Документация Litport
Используйте Litport как поставщика прокси или получайте публичный список бесплатных прокси. Эти страницы описывают поведение развёрнутой версии, включая точные данные для подключения, лимиты, ошибки и структуры ответов.
Выбор интеграции#
| Цель | С чего начать | Аутентификация |
|---|---|---|
| Получить публичные бесплатные прокси | API бесплатных прокси | Не нужна |
| Подключиться через купленный прокси | Токены, прокси-продукты и хабы | Логин и пароль токена прокси |
| Зашифровать соединение с самим прокси | HTTPS-эндпоинт прокси | Логин и пароль токена прокси по TLS |
| Выбрать географию PPG или сессию с фиксированным IP | Параметры прокси с оплатой за ГБ | Параметры в логине прокси |
| Составить список существующих токенов, прочитать использование или изменить локацию, ротацию или IP перемещаемого токена | Litport API | API-ключ в заголовке Bearer |
| Прочитать состояние пакета или управлять его разрешёнными IP | API пакетов | API-ключ в заголовке Bearer |
| Отдавать повторные статические HTTPS-ответы бесплатно | Кеш статических ответов | Логин и пароль токена прокси с суффиксом кеша |
| Дать ИИ-ассистенту доступ к Litport API | MCP-сервер для ИИ-ассистентов | API-ключ в заголовке Bearer |
Записи в API — это локация токена, ротация и новый IP, а также разрешённые IP пакета; для любой записи нужен API-ключ в заголовке Bearer. Сами токены нельзя создавать или удалять через API.
Быстрый старт с бесплатным API#
curl --get 'https://litport.net/api/free-proxy' \
--data-urlencode 'country=us' \
--data-urlencode 'protocol=https' \
--data-urlencode 'limit=25'
Ответ — JSON-массив без обёртки. Этот эндпоинт публичный и не использует API-ключ.
Быстрый старт с API#
Создайте API-ключ на странице Настройки, поместите его в переменную окружения, затем выведите список существующих токенов:
export LITPORT_API_KEY='lit_replace_with_your_key'
curl --fail-with-body 'https://litport.net/api/v1/tokens?limit=20' \
-H "Authorization: Bearer $LITPORT_API_KEY"
Никогда не помещайте ключ в URL, логин прокси, клиентское приложение, лог или сообщение в поддержку.
Данные для подключения и идентификаторы#
| Термин | Значение |
|---|---|
| Логин/пароль токена прокси | Данные для подключения плоскости данных, которые отправляются на HTTP- или SOCKS5-эндпоинт прокси. |
| ID токена прокси | Постоянный несекретный идентификатор |
API-ключ пользователя (lit_…) |
Учётные данные плоскости управления аккаунта, передаются только как Authorization: Bearer …. |
API-ключ не является паролем прокси и не может открыть соединение через прокси. ID токена прокси не является секретом.
Машиночитаемые ресурсы#
- Контракт OpenAPI 3.1
- Индекс документации для кодинг-агентов
- Сводная документация в формате Markdown
- Каждая страница доступна в формате Markdown по ссылке Markdown.
Семантические HTML-страницы — канонические. HTML, Markdown, навигация и ресурсы для агентов генерируются из одних и тех же исходных файлов, чтобы уменьшить расхождения в контракте.
Основы работы#
- Используйте метки времени ISO-8601 в UTC, например
2026-08-25T12:00:00Z. - Считайте счётчики байтов десятичными строками; JavaScript-клиентам не следует приводить большие значения к
Number. - Для сбоев плоскости данных читайте ошибки прокси, для сбоев REST — ошибки API. Это разные системы ошибок.
- Указывайте заголовок ответа
X-Request-ID, когда сообщаете о сбое API.