Этот API предоставляет доступ к списку прокси-серверов с возможностью настройки фильтров. Для работы с API требуется действующий ключ доступа, который проверяется на подлинность и соблюдение лимитов использования. В ответ на запрос пользователь получает данные в зависимости от параметра get
в виде текста, JSON или файла для скачивания. API доступен по адресу https://api.good-proxies.ru/api
.
Параметр | Описание | Обязательный | Пример значения |
---|---|---|---|
key | Ключ доступа, необходимый для аутентификации запроса. | Да | abc123 |
type | Тип прокси-серверов (http, https, socks4, socks5). Можно указать несколько типов через запятую. | Нет | http,https |
anon | Уровень анонимности прокси (transparent, anonymous, elite). | Нет | elite |
ping | Максимально допустимое время отклика прокси в миллисекундах. | Нет | 500 |
time | Максимальное время (в секундах) с момента последней проверки прокси. | Нет | 600 |
works | Количество успешных тестов прокси из общего числа попыток в процентах. Доступные значения: от 0 до 100. Пример использования: works=50 — это значит, что будут выданы прокси, у которых не менее 50% успешных проверок из общего числа тестов на работоспособность. Выводится значение, если выбран формат json . |
Нет | 50 |
country | Код страны прокси (ISO Alpha-2). Можно указать несколько кодов через запятую. | Нет | us,ca |
city | Название города прокси. Можно указать несколько городов через запятую. Названия могут быть на русском или английском языке. | Нет | Париж,Москва |
count | Количество запрашиваемых прокси. | Нет | 10 |
get | Формат вывода данных. По умолчанию используется значение txt , что означает вывод в виде текста в браузере. Для вывода в формате JSON используйте get=json . Для скачивания файла используйте get=txt.file или get=json.file . |
Нет | txt, json, txt.file, json.file |
timecheck | Время последней успешной проверки на работоспособность прокси. Выводится только если выбран формат json . Время указывается в часовом поясе GMT+2. |
Нет | Нельзя указать |
ip_out | Исходящий результатирующий IP-адрес прокси. Может отличаться от основного IP-адреса прокси. Этот параметр выводится только в формате JSON. | Нет | Нельзя указать |
GET https://api.good-proxies.ru/api?key=abc123&type=http&anon=elite&count=5&get=json
GET https://api.good-proxies.ru/api?key=abc123&type=https&ping=500&count=10&get=txt.file
GET https://api.good-proxies.ru/api?key=abc123&country=us,ca&count=2
При успешном запросе с параметром get=json
, API возвращает список прокси-серверов в структурированном формате JSON. Включает параметр timecheck
, который показывает время последней успешной проверки в часовом поясе GMT+2. Параметр ip_out
указывает результатирующий IP-адрес прокси, который может отличаться от основного.
[ { "ip": "15.162.126.1:919", "ip_out": "15.162.126.1:919", "type": "http", "anon": "transparent", "ping": 5.07786, "timecheck": "2024-11-25 20:09:25", "country": "CO", "city": "Медельин", "works": "66" } ]
Если параметр get=txt
(по умолчанию), данные возвращаются в виде простого текстового файла, отображаемого в браузере:
192.168.1.1:8080 192.168.1.2:8080 192.168.1.3:8080
Если параметр get=txt.file
, данные будут предложены для скачивания в текстовом формате:
192.168.1.1:8080 192.168.1.2:8080 192.168.1.3:8080
Если параметр get=json.file
, данные будут предложены для скачивания в формате JSON:
[ { "ip": "112.63.11.8:180", "ip_out": "122.63.41.1:380", "type": "http", "anon": "elite", "ping": 3.83659, "timecheck": "2024-11-25 20:09:26", "country": "SN", "city": "", "works": "100" } ]
Если запрос не удался, API возвращает текстовое сообщение с описанием ошибки.
Ошибка: Ключ доступа не предоставлен
key
, являются необязательными.count
не указан, API возвращает максимальное количество доступных прокси.get=txt.file
или get=json.file
данные будут предложены для скачивания как файл.timecheck
, возвращаемое в формате JSON, указывается в часовом поясе GMT+2.$key = 'abc123'; $type = 'http'; $anon = 'elite'; $count = 5; $get = 'json'; $url = "https://api.good-proxies.ru/api?key=$key&type=$type&anon=$anon&count=$count&get=$get"; $response = file_get_contents($url); if ($response) { $proxies = json_decode($response, true); print_r($proxies); } else { echo "Ошибка при получении прокси."; }
API предоставляет удобный инструмент для получения прокси-серверов с широкими возможностями фильтрации. Убедитесь, что у вас есть действующий ключ доступа, и соблюдайте лимиты для бесперебойной работы с сервисом.