# От пустого аккаунта до запроса с выходом в выбранной вами локации.

Пять шагов, не нужно устанавливать SDK, подойдёт любой HTTP-клиент. Десять минут, если у вас уже есть криптовалюта.


## Пять шагов

1. **Создайте аккаунт и пополните кошелёк** Зарегистрируйтесь с помощью адреса электронной почты, затем пополните счёт на сумму от $20 в любой доступной монете (BTC, ETH, USDT, USDC, LTC, XMR, SOL, TRX, DOGE). Баланс будет зачислен после подтверждения транзакции в её сети, обычно в течение нескольких минут, и не имеет срока действия.
2. **Скопируйте учётные данные шлюза** На панели управления отображаются один логин и один пароль для общих шлюзов (резидентских и мобильных). Заказы выделенных ISP, серверных и мобильных прокси вместо этого содержат собственные строки `ip:port:user:pass`.
3. **Выберите эндпоинт для задачи** У каждой общей сети есть своё доменное имя; локация выбирается в логине, а не в доменном имени. Выделенные продукты используют собственные `ip:port`.

   Сеть | Эндпоинт | HTTP(S) | SOCKS5 | Резидентские прокси | res.hodlproxy.com | 9000 | 9001 | Мобильные прокси с ротацией IP | mob.hodlproxy.com | 9000 | 9001 | ISP, серверные прокси, мобильное устройство | IP из вашего списка | 8000 | 8001 |
4. **Отправьте первый запрос** В примере сервис определения IP спрашивается, какой адрес он видит. `-cc-us` в логине запрашивает выходной узел в США; запустите команду дважды, и получите адреса двух разных домохозяйств.

   cURLPythonNode.jsPHPGocURLКопироватьcurl -x http://USER-cc-us:PASS@res.hodlproxy.com:9000 https://api.ipify.orgPythonКопироватьimport requests proxy = "http://USER-cc-us:PASS@res.hodlproxy.com:9000" r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=30) print(r.text)Node.jsКопироватьimport { fetch, ProxyAgent } from "undici"; const dispatcher = new ProxyAgent("http://USER-cc-us:PASS@res.hodlproxy.com:9000"); const res = await fetch("https://api.ipify.org", { dispatcher }); console.log(await res.text());PHPКопировать$ch = curl_init("https://api.ipify.org"); curl_setopt_array($ch, [ CURLOPT_PROXY => "http://res.hodlproxy.com:9000", CURLOPT_PROXYUSERPWD => "USER-cc-us:PASS", CURLOPT_RETURNTRANSFER => true, ]); echo curl_exec($ch);GoКопироватьproxyURL, _ := url.Parse("http://USER-cc-us:PASS@res.hodlproxy.com:9000") client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}} resp, err := client.Get("https://api.ipify.org")
5. **Уточните таргетинг и закрепите IP** Каждый параметр представляет собой пару `-key-value`, добавляемую к логину: `-city-berlin` вместе с `-cc-de` выбирает конкретный город, `-sid-a1b2c3` сохраняет один IP между запросами, а `-ttl-30m` задаёт срок его сохранения. На странице [Таргетинг и сессии](https://hodlproxy.com/ru/docs/username-parameters) перечислены все параметры.

   ```
   # Одно домохозяйство в Берлине, закреплённое на 30 минут между запросами
   curl -x http://USER-cc-de-city-berlin-sid-a1b2c3-ttl-30m:PASS@res.hodlproxy.com:9000 \
        https://api.ipify.org
   ```

> Tip: Проверьте результат: вставьте IP, возвращённый сервисом определения IP, в любую общедоступную базу геолокации. Он должен определяться как адрес из запрошенной страны, принадлежащий провайдеру для частных пользователей.


## Что дальше

- [Аутентификация](https://hodlproxy.com/ru/docs/authentication): Логин и пароль или белый список IP, а также передача параметров с каждым запросом.
- [Таргетинг и сессии](https://hodlproxy.com/ru/docs/username-parameters): Страна, регион, город, ASN, закреплённые сессии и срок их действия.
- [Примеры кода](https://hodlproxy.com/ru/docs/examples): Python, Node.js, PHP, Go, Java, C#, Playwright, Puppeteer, Scrapy и другие.
- [Ошибки и устранение неполадок](https://hodlproxy.com/ru/docs/errors): Что означает каждый код состояния от шлюза и что нужно изменить.


Источник: https://hodlproxy.com/ru/docs/quickstart