ProxyMania API
Базовый URL: https://proxymania.su/api/
API ключ: отображается в личном кабинете на странице профиля
-
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,17282GET параметры:
type—ipv4илиipv6country(необязательный для 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,17282GET параметры:
type—ipv4илиipv6comment— текст комментария
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.11GET параметры:
type—ipv4илиipv6status—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 авторизации