API для резидентных прокси
Мы предоставляем резидентные прокси с оплатой за трафик. Для корректной работы API необходимо купить трафик резидентных прокси. Если ваш трафик закончился, то некоторые запросы не будут работать.
Запросы к API
Для работы с API требуется ключ. Вы можете узнать его на странице Профиль.
Общий вид запроса:
https://thesafety.us/getapi?key=[API ключ]&act=[имя запроса]
Остаток трафика
Для проверки остатка трафика используйте act=traffic
https://thesafety.us/getapi?key=[API ключ]&act=traffic
Ответ будет в виде XML.
Поле auth = true, если API ключ верный.
Поле resident-traffic-in-mb показывает оставшийся трафик в Мегабайтах.
Список стран, городов, штатов
Актуальный список можно получить, используя act=countries
https://thesafety.us/getapi?key=[API ключ]&act=countries
Ответ будет в виде XML.
Поле auth = true, если API ключ верный.
Поле resident содержит теги country (полное название страны) и code (код страны). Для API необходимо указывать code (код страны).
Для некоторых стран указаны города в теге city и штаты в теге state. Города и штаты указаны списком, разделитель запятая.
Генерация списка прокси
Список прокси можно получить через act=getresproxy
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy
Ответ будет в виде text/plain. Данный запрос выдаст прокси для любой страны с динамическим IP адресом. Страна и IP адрес будут выбраны случайно при каждом запросе.
Дополнительные параметры:
| Параметр | Комментарий |
|---|---|
| &type= | Тип прокси:
http = HTTP/HTTPS прокси socks5 = Socks5 прокси Если type не указан по-умолчанию используется http. |
| $list= | Формат списка прокси:
hpup = hostname:port:username:password hp@up = hostname:port@username:password uphp = username:password:hostname:port up@hp = username:password@hostname:port Если list не указан по-умолчанию используется hpup. |
| Выбор страны, города, штата | |
| &country= | 2х буквенный код страны [параметр code из запроса act=countries] |
| &city= | Название города [параметр city из запроса act=countries]
Система будет стараться выдавать IP адреса в указанной локации, но это не гарантируется. Не используйте одновременно с параметром &state= Работает только вместе с указанием страны &country= |
| &state= | Название штата [параметр state из запроса act=countries]
Система будет стараться выдавать IP адреса в указанной локации, но это не гарантируется. Не используйте одновременно с параметром &city= Работает только вместе с указанием страны &country= |
| Получение статического IP адреса | |
| &session=1 | Указывает использовать статический IP адрес, который формируется в пароле прокси через параметр session.
Если session не указан, то всегда выдается 1 прокси с динамическим IP адресом, меняющимся при каждом запросе. Смена IP адреса реализована на прокси-сервере и не требует от пользователя дополнительных настроек. |
| &amount= | Указывает необходимое количество прокси для генерации.
Возможные значения от 1 до 1000. Работает только вместе с параметром &session=1 |
| &lifetime= | Время, после которого статический IP адрес заменяется на новый.
Возможные параметры в секундах, минутах и часах: 5-59s, 1-59m, 1-24h Пример: 30s - менять IP адрес каждые 30 секунд 10m - менять IP адрес каждые 10 минут 6h - менять IP адрес каждые 6 часов Система будет стараться работать по указанному параметру, но это не гарантируется.
Работает только вместе с параметром &session=1 |
Примеры запросов:
Список из 10 HTTP/HTTPS прокси со статическим IP адресом в Германии в формате up@hp
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=de&type=http&list=up@hp&session=1&amount=10
Socks5 прокси с динамическим IP адресом в США в формате hpup
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&type=socks5&list=hpup
HTTP/HTTPS прокси с динамическим IP адресом в США, штат Юта
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&state=utah
HTTP/HTTPS прокси с динамическим IP адресом в Канаде, город Montreal
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=ca&city=montreal
Есть предложения по улучшению API? Свяжитесь с нами.