API для резидентных прокси

Мы предоставляем резидентные прокси с оплатой за трафик. Для корректной работы API необходимо купить трафик резидентных прокси. Если ваш трафик закончился, то некоторые запросы не будут работать.


Запросы к API

Для работы с API требуется ключ. Вы можете узнать его на странице Профиль.

Общий вид запроса:

https://thesafety.us/api?key=[API ключ]&act=[имя запроса]


Остаток трафика

Для проверки остатка трафика используйте act=traffic

https://thesafety.us/api?key=[API ключ]&act=traffic

Ответ будет в виде XML.

Поле auth = true, если API ключ верный.

Поле resident-traffic-in-mb показывает оставшийся трафик в Мегабайтах.



Список стран, городов, штатов

Актуальный список можно получить, используя act=countries

https://thesafety.us/api?key=[API ключ]&act=countries

Ответ будет в виде XML.

Поле auth = true, если API ключ верный.

Поле resident содержит теги country (полное название страны) и code (код страны). Для API необходимо указывать code (код страны).

Для некоторых стран указаны города в теге city и штаты в теге state. Города и штаты указаны списком, разделитель запятая.



Генерация списка прокси

Список прокси можно получить через act=getresproxy

https://thesafety.us/api?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/api?key=[API ключ]&act=getresproxy&country=de&type=http$list=up@hp&session=1&amount=10

Socks5 прокси с динамическим IP адресом в США в формате hpup

https://thesafety.us/api?key=[API ключ]&act=getresproxy&country=us&type=socks5$list=hpup

HTTP/HTTPS прокси с динамическим IP адресом в США, штат Юта

https://thesafety.us/api?key=[API ключ]&act=getresproxy&country=us&state=utah

HTTP/HTTPS прокси с динамическим IP адресом в Канаде, город Montreal

https://thesafety.us/api?key=[API ключ]&act=getresproxy&country=ca&city=montreal



Есть предложения по улучшению API? Свяжитесь с нами.




Задать нам вопрос