apiKey
Строка
Обязательный
Ваш ключ API для доступа к премиум списку прокси. Для того чтобы получить этот ключ, откройте приборную панель.
amount
Число
Опциональный
Выберет количество прокси равное значению.
Если этот параметр не указан, то выберет все прокси.
uptime
Число
Опциональный
Выберет прокси с процентом непрерывной работы больше, или равно значению.
Допустимое значение от 1 до 100.
Если этот параметр не указан, или значение равно 1, то выберет все прокси.
streak
Число
Опциональный
Выберет прокси с количеством успешных проверок подряд больше, или равно значению. Доступно только для живых прокси.
Допустимое значение от 1 до 100.
Если этот параметр не указан, или значение равно 1, то выберет все прокси.
all
Число
Опциональный
Выберет живые и мёртвые прокси.
Допустимое значение: 1.
Если этот параметр не указан, то выберет только живые прокси.
smart
Число
Опциональный
Будет фильтровать прокси с одинаковыми исходящими IP адресами и извлекать только один с лучшими параметрами.
Допустимое значение: 1.
Если этот параметр не указан, то выберет все прокси.
timeout
Число
Опциональный
Выберет прокси с временем ответа меньше, или равному значению, в миллисекундах.
Допустимое значение от 1 до 10000.
Если этот параметр не указан, или значение равно 10000, то выберет все прокси.
stable
Массив из Чисел
Опциональный
Выберет прокси по стабильности соединения.
Допустимые значения: [1,2,3].
1 - Высокая.
2 - Средняя.
3 - Низкая.
Пример: 1,2.
Если этот параметр не указан, или заданы все 3 значения, то выберет все прокси.
services
Массив из Чисел
Опциональный
Выберет прокси по доступным сервисам: гугл поиск, сайт телеграма.
Допустимые значения: [1,2].
1 - Google.
2 - Telegram.
Пример: 2.
Если этот параметр не указан, то выберет все прокси.
anons
Массив из Чисел
Опциональный
Выберет прокси по анонимности.
Допустимые значения: [1,2,3].
1 - Elite.
2 - Anonymous.
3 - Transparent.
Пример: 1,2.
Если этот параметр не указан, или заданы все 3 значения, то выберет все прокси.
protocols
Массив из Чисел
Опциональный
Выберет прокси по протоколам.
Допустимые значения: [1,2,3,4].
1 - Http.
2 - Https.
3 - Socks4.
4 - Socks5.
Пример: 1,3.
Если этот параметр не указан, или заданы все 4 значения, то выберет все прокси.
countries
Массив из Строк
Опциональный
Выберет прокси по странам.
Допустимы все коды стран, доступные на данный момент.
Пример: BD,ID,US.
Если этот параметр не указан, то выберет все прокси.
Ограничения
Для предотвращения абуза нашего сервиса, применяются следующие правила:
10000 звпросов в день.
Если вы превысили 10000 запросов, вы будете заблокированы на 2 дня.
Пожалуйста, тестируете своё ПО, для избежания блокировок.
Разрешается 2 полностью разных IP адреса в день + 1 к 2-м последним октетам, если вы используете ipv4. Для ipv6 (4 последние подсети).
Пример ipv4:
- 127.1.50.28, 127.1.67.32
- 10.23.157.17, 10.23.100.53
Пример ipv6:
- 2001:0DB8:ABCD:0012:0000:0000:ABCD:0000, 2001:0DB8:ABCD:0012:FFFF:FFFF:FFFF:FFFF
- FE80:CD00:0000:CDEA:1257:0000:211E:729C, FE80:CD00:0000:CDEA:FFFF:FFFF:FFFF:FFFF
Суммарно разрешено 4 IP адреса.
Если вы превысите лимит, то вы получите ошибку 403 с сообщением 'You already reach different IPs limit per day, retry from your old IP address.'.
Как узнать мой текущий статус использования, например: окончание подписки, статус блокировки, текущее кол-во запросов, используемые IP адреса? Смотрите пример ниже.
GET:
Конечная точка:
https://api.openproxy.space/premium/details/
Полный запрос:
https://api.openproxy.space/premium/details/:apiKey
Пример ответа (если вы уже использовали API сегодня):
{
"status": "used",
"ts": 1567008457115,
"ips": {
"xx.xx": [
"xx.xx.xxx.xx",
"xx.xx.xxx.xxx"
],
"xxx.xx": [
"xxx.xx.xxx.xx",
"xxx.xx.x.xxx"
]
},
"hits": {
"used": 75,
"total": 10000,
"remaining": 9925
},
"blocked": false,
"access": {
"stage": 2,
"expireHuman": "Thu Sep 26 2019 15:27:56 GMT+0200 (GMT+02:00)",
"expireTS": 1569500876137
}
}
Пример ответа (если нет):
{
"status": "new",
"blocked": false,
"access": {
"stage": 2,
"expireHuman": "Thu Sep 26 2019 15:27:56 GMT+0200 (GMT+02:00)",
"expireTS": 1569500876137
}
}
Пример ответа с блокировкой:
{
"blocked": {
"status": true,
"message": "You reached 10000 hits per day, looks like DOS attack.",
"expireHuman": "Fri Aug 30 2019 19:07:56 GMT+0200 (GMT+02:00)",
"expireTS": 1567181276642
}
}Конечная точка:
https://api.openproxy.space/premium/json
Полный запрос:
https://api.openproxy.space/premium/json?apiKey=
Пример ответа:
[{
"protocols": [
1,
2
],
"services": {
"google": false,
"telegram": true
},
"uptime": 100,
"ip": "127.0.0.1",
"port": 3128,
"anon": 3,
"timeout": 5672,
"country": "FR",
"cascade": {
"ip": "127.0.0.12",
"country": "BD"
},
"stable": 1,
"streak": 2,
"updated": 1556703635795
}]