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-адреса обиратимуться випадково для кожного запиту.
Додаткові параметри:
| Параметр | Коментар |
|---|---|
| &base= | База проксі:
Цей параметр можна дізнатися із запиту act=countries Якщо база проксі одна, параметра може не бути. |
| &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-адресою, що змінюється з кожним запитом. Зміна відбувається на проксі-сервері й не потребує додаткових налаштувань користувача. |
| &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? Зв'яжіться з нами.