API | ProxyMania.su

GET /api/get_proxies/{apikey}/?filter=&extended=0|1

Параметры:

filter (необязательный) — фильтрация по значению поля комментарий
extended (необязательный) — 0 или 1, выдавать ли расширенную информацию

Успешный ответ:

[
    {
        "id": 12345,
        "ipv6": "2a00:1234:5678:90ab::1",
        "http": "192.168.1.1:8080",
        "socks": "192.168.1.1:1080",
        "username": "user123",
        "password": "pass456",
        "comment": "my proxy",
        // при extended=1:
        "expire": "2025-12-31 23:59:59",
        "ip_auth": 0,
        "ip_auth_addr": "",
        "status": 0,
        "country": "ru"
    }
]

Возможные ошибки:

code: 1 — неверный API ключ

GET /api/get_countries/{apikey}?type=ipv4|ipv6

Параметры:

type (необязательный) — ipv4 или ipv6. Если не указан, возвращает все типы доступные к покупке

Успешный ответ (type=ipv4):

[
    {
        "alpha2": "r4",
        "name": "Россия IPv4",
        "price_ipv4": 119,
        "price_ipv4_2": 99
    }
]

Цены IPv4 (за 1 прокси/месяц):

price_ipv4 — при покупке от 1 до 99 шт.
price_ipv4_2 — при покупке от 100 шт.

Примечания:

Для IPv4 alpha2 — код страны (r4 — Россия, персональные прокси, s4 — Россия, shared прокси)

Успешный ответ (type=ipv6):

[
    {
        "alpha2": "ru",
        "name": "Россия",
        "price_ipv6": 7,
        "price_ipv6_2": 6,
        "price_ipv6_3": 5,
        "price_ipv6_4": 4.5,
        "price_ipv6_5": 4,
        "price_ipv6_6": 3.5,
        "price_ipv6_7": 3
    }
]

Цены IPv6 (за 1 прокси/месяц):

price_ipv6 — при покупке от 1 до 9 шт.
price_ipv6_2 — при покупке от 10 до 99 шт.
price_ipv6_3 — при покупке от 100 до 199 шт.
price_ipv6_4 — при покупке от 200 до 299 шт.
price_ipv6_5 — при покупке от 300 до 399 шт.
price_ipv6_6 — при покупке от 400 до 499 шт.
price_ipv6_7 — при покупке от 500 шт.

Возможные ошибки:

code: 1 — неверный API ключ

GET /api/get_freeproxys/{apikey}?country={countrycode}

Параметры:

country — код страны (r4 — dedicated, s4 — shared)

Успешный ответ:

150

Возвращает число — количество доступных прокси

Возможные ошибки:

code: 1 — неверный API ключ

GET /api/get_balance/{apikey}/

Успешный ответ:

{
    "status": "ok",
    "balance": "502"
}

Возможные ошибки:

code: 1 — неверный API ключ

GET /api/buy_proxies/{apikey}?country=&count=&type=&period=&protocol=

Параметры:

country — код страны из списка доступных стран
count — количество прокси для покупки
type — ipv4 или ipv6 (по умолчанию ipv6)
period (необязательный) — период аренды (по умолчанию 30). Допустимые значения IPv6: 3, 7, 14, 30, 60, 90, 180 дней. Для IPv4: 30, 60, 90, 180 дней
protocol (необязательный) — https или socks5 (по умолчанию https)

Пример запроса:

GET https://proxymania.su/api/buy_proxies/12b4493473dcd1c70d8f4b1c7a5ffc3c?country=s4&count=10&type=ipv4&period=30

Успешный ответ:

{
    "status": "ok",
    "purchase_id": "a1b2c3d4e5f6...",
    "sum": 300
}

Возможные ошибки:

code: 1 — неверный API ключ
code: "error count" — некорректное количество
code: "country not set" — не указана страна
code: "country not found" — страна не найдена
code: "country not active" — страна не активна для покупки
code: "invalid period" — некорректный период (см. минимум)
code: "insufficient funds" — недостаточно средств (возвращает required и balance)
code: "no available proxies" — нет доступных прокси
code: "not enough proxies" — недостаточно прокси (возвращает available и requested)

Примечания:

purchase_id — устанавливается в комментарий купленных прокси
sum — списанная сумма с баланса
IPv4 прокси выдаются сразу и активируются в течении 1 мин.
IPv6 прокси: проверяйте get_proxies с filter=purchase_id каждые 30 секунд

Внимание: Не интегрируйте API покупки напрямую в десктопный софт с захардкоженным ключом — делайте серверную прослойку.

POST /api/renew/{apikey}?type=ipv4|ipv6&country=
proxy_ids=13582,17371,17282

GET параметры:

type — ipv4 или ipv6
country (необязательный для IPv6) — код страны

POST параметры:

proxy_ids — список ID прокси для продления, разделённых запятыми

Успешный ответ:

{
    "status": "ok",
    "transaction_id": 12345,
    "sum": 300
}

Возможные ошибки:

code: 1 — неверный API ключ
code: 2 — некорректное количество прокси
code: 3 — недостаточно средств (возвращает required и balance)
code: 4 — не указаны ID прокси
code: "invalid type" — не указан или неверный тип
code: "country not found" — страна не найдена
msg: "user check fail" — прокси не принадлежит пользователю
msg: "country check fail" — страна прокси не соответствует указанной

Примечание: Можно продлевать прокси разных стран в одном запросе — цена рассчитывается автоматически.

POST /api/set_comment/{apikey}?type=ipv4|ipv6&comment=example
proxy_ids=13582,17371,17282

GET параметры:

type — ipv4 или ipv6
comment — текст комментария

POST параметры:

proxy_ids — список ID прокси, разделённых запятыми

Успешный ответ:

{
    "status": "ok"
}

Возможные ошибки:

code: 1 — неверный API ключ
code: 2 — некорректное количество прокси
code: 4 — не указаны ID прокси
msg: "user check fail" — прокси не принадлежит пользователю
msg: "comment not set" — ошибка установки комментария

POST /api/replace_proxies/{apikey}
proxy_ids=13582,17371,17282

Параметры (POST body):

proxy_ids — список ID прокси для замены, разделённых запятыми

Успешный ответ:

{
    "status": "ok"
}

Возможные ошибки:

code: 1 — неверный API ключ
code: 4 — превышен лимит замен за раз
code: 5 — превышен суточный лимит замен
code: 6 — замена уже была выполнена недавно (таймаут)
code: 7 — прокси с указанным ID не найден

Примечания:

Общий лимит 1000 шт. прокси в час, для каждого отдельного прокси таймаут так же стоит 1 час на замену
Меняется только внешний IPv6 адрес, ip:port:login:pass для подключения остаются прежними

POST /api/set_ipauth/{apikey}?type=ipv4|ipv6&status=on|off
proxy_ids=13582,17371,17282&ip=185.33.22.11

GET параметры:

type — ipv4 или ipv6
status — on (установить привязку) или off (удалить)

POST параметры:

proxy_ids — список ID прокси, разделённых запятыми
ip — IP адрес для авторизации (при status=on)

Успешный ответ:

{
    "status": "ok"
}

Возможные ошибки:

code: 1 — неверный API ключ
code: 2 — некорректное количество прокси
code: 4 — не указаны ID прокси
msg: "user check fail" — прокси не принадлежит пользователю
msg: "wrong ip for auth" — некорректный IP адрес (0.0.0.0, 255.255.255.255 или невалидный)
msg: "ip not set" — ошибка установки IP авторизации

ProxyMania API