Два разных адреса. Их нельзя менять местами.
Прокси для трафика — строка из ответа, её ставят в программу:
gw.hellproxy.com:8797:ЛОГИН:ПАРОЛЬ
Это обычный HTTP-прокси, метод CONNECT. В выданной строке порт 8797. Тот же вход есть и на порту 443. На этих портах нет списка и нет покупки. Формат url начинается с https:// — сертификат шлюза самоподписанный, программа должна его не проверять. Форматы host и user идут без TLS.
API — только чтобы купить строку и посмотреть свои:
https://hellproxy.com/v1
Сюда нельзя слать CONNECT и нельзя ходить через него как через прокси. Ответ всегда JSON. Без ключа открой GET / — там короткая карта адресов. Ключ один раз создаётся в кабинете или в боте.
GET /v1/me баланс и уже купленные строки GET /v1/proxies список, поле proxy в каждой POST /v1/proxies купить, в ответе поле proxy
Те же действия есть короткими путями: /me, /proxy, /proxies, /lines, /generate.
Любой из трёх способов:
GET /v1/proxies?key=КЛЮЧ
X-Api-Key: КЛЮЧ
{"key":"КЛЮЧ"}
Чужой ключ и пустой ключ отвечают 401 и телом {"error":"ключ"}.
Списание идёт с того же баланса, что в боте и на сайте. Цена = цена за 1 ГБ × gb.
MOBILE_PROXY — мобильный, $1.00 за 1 ГБ.
RP — резидентский, $0.80 за 1 ГБ.
DC — датацентр, $0.35 за 1 ГБ.
GET /v1/proxies?key=КЛЮЧ
Ответ: {"proxies":[ ... ]}. В списке только покупки этого ключа.
GET /v1/proxies/ID?key=КЛЮЧ
ID — это логин прокси, его же видно в строке. Чужой или несуществующий ID отвечает 404 {"error":"нет такого прокси"}.
POST /v1/proxies
Content-Type: application/json
{"key":"КЛЮЧ","product":"MOBILE_PROXY","gb":10,"geo":"DE","rotation":"5","format":"url"}
product — MOBILE_PROXY, RP или DC. Другое значение: 400.
gb — целое от 1 до 500. Дробное и пустое: 400.
geo — две латинские буквы страны, например DE, US, TH, GB. Поле можно не передавать, тогда страна любая. UK записывается как GB. Не две буквы: 400.
rotation — как часто меняется IP. Число это минуты: 1, 5, 10, 30, 60, 120, 360, 1440. rotate — новый IP на каждый запрос. sticky — один IP, пока сам не сменишь. Другое значение: 400.
format — вид строки. host: хост:порт:логин:пароль. user: логин:пароль@хост:порт. url: https://логин:пароль@хост:порт. По умолчанию host.
protocol в теле можно передать, на выдачу он не влияет. Шлюз всегда HTTP CONNECT, хост gw.hellproxy.com, порт в строке 8797.
POST /v1/proxies/ID
{"key":"КЛЮЧ","geo":"US"}
Меняется только geo уже купленной строки. UK снова становится GB. Чужой ID: 404. Новый пакет при этом не покупается и баланс не трогается.
{"id":"a1b2c3d4","product":"MOBILE_PROXY","label":"Мобильный","gb":10,"geo":"DE","rotation":"5","protocol":"http","format":"url","proxy":"https://a1b2c3d4:пароль@gw.hellproxy.com:8797"}
id и логин — одно и то же. Пароль есть только внутри поля proxy. Поле gb — сколько гигабайт осталось, bought — сколько было куплено. Если выдано несколько строк, они лежат в proxies, трафик у них общий. Трафик пакета кончается на bought гигабайт. Дальше шлюз отвечает 407, так же как на неверный пароль. Если линия не поднялась, ответ 502.
400 — тело не JSON или поле не из списка выше. В error написано, какое поле.
401 — ключ не подошёл.
402 — {"error":"не хватает баланса"}. Деньги не списываются.
409 — этого объёма сейчас нет в запасе. Деньги возвращаются на баланс. Купи меньше гигабайт или другой тип.
404 — нет такого адреса или такого прокси.
curl -s https://hellproxy.com/v1/proxies \
-H "X-Api-Key: КЛЮЧ"
curl -s https://hellproxy.com/v1/proxies \
-H "Content-Type: application/json" \
-d '{"key":"КЛЮЧ","product":"RP","gb":2,"geo":"DE","rotation":"sticky","format":"host"}'