Ключ даёт доступ к чтению списка и реквизитов прокси. Всего можно создать 20 ключей.
Запросить случайный прокси
Без фильтров — любой действующий прокси. Можно указать регион, страну или оба фильтра сразу. Просроченные прокси не выдаются.
Ответ
{
"id": "…",
"protocol": "http",
"host": "proxy.example",
"port": 10000,
"username": "login",
"password": "password",
"url": "http://login:[email protected]:10000",
"region": "europe",
"country": "DE",
"expires_at": null
}
Фильтры
regioneurope, asia, northern_america, latin_america_and_caribbean, africa, oceania, world_mix, custom, unknowncountry- Двухбуквенный код:
DE, US, TR, XK или unknown. protocolhttp, https, socks4, socks5.search- Часть хоста или логина.
Методы
expires_at — дата и время в RFC 3339 с часовым поясом, null — без ограничения. В списке expired показывает, истёк ли срок. При импорте и проверке списка поле expires_at применяется ко всем новым прокси. В интерфейсе даты показаны в часовом поясе браузера.
Фильтры работают для списка, случайного прокси и экспорта. Все заданные фильтры должны совпасть. World Mix и Custom — сохранённые метки региона, не синоним «любой».
401 — неверный или отозванный ключ; 403 — действие запрещено; 404 — прокси не найден; 400 — неверные параметры. Пример ошибки: {"error":{"code":"not_found","message":"Proxy not found"}}. Сервис выдаёт сохранённые реквизиты; доступность и фактический IP прокси не проверяются.