Этот 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 предоставляет удобный инструмент для получения прокси-серверов с широкими возможностями фильтрации. Убедитесь, что у вас есть действующий ключ доступа, и соблюдайте лимиты для бесперебойной работы с сервисом.