Hell Proxy API

Два разных адреса. Их нельзя менять местами.

Прокси для трафика — строка из ответа, её ставят в программу:

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"}'

На сайт