ProxyMania API
-
Параметр apikey – ключ отображается в личном кабинете на странице https://proxymania.ru/dashboard/
Параметры filter и extended необязательные.
filter – значение поля комментарий, по которому будет идти фильтрация.
<0/1> для extended – выдавать ли расширенную информацию, такую как дата окончания и прочее.Одно из полей ответа, а именно "id", будет необходимо для дальнейшей идентификации прокси при запросах на замену и т.д.
GET /api/get_proxies/apikey/?[filter=]&[extended=<0/1>]
Пример запроса:
GET https://proxymania.ru/api/get_proxies/12b4493473dcd1c70d8f4b1c7a5ffc3c/?extended=1
-
proxy_ids – список "id" прокси для замены, разделенных запятыми (пример: "13582,17371,17282" – в запросе без кавычек)
POST /api/replace_proxies/apikey proxy_ids=
-
– возвращает код стран (тарифов) доступных для покупки и их описание
GET /api/get_countries/apikey
-
– возвращает количество доступных для покупки прокси для указанной страны r4 или s4
GET /api/get_freeproxys/apikey?country=[countrycode]
-
– возвращает текущий баланс профиля
GET /api/get_balance/apikey/
-
GET /api/buy_proxies/apikey?country=&count=&type=ipv4/ipv6
country – код страны, полученый в результате запроса на список стран, доступных для покупки. Можно, конечно, поиграться и написать в это поле рандомные символы, но деньги спишутся, а прокси не появятся.
count – количество прокси для покупки.
type – тип прокси IPv4 или IPv6 (если значение не указано, по умолчанию будет считать IPv6)Пример запроса на покупку 10 IPv4 Shared прокси:
GET https://proxymania.su/api/buy_proxies/12b4493473dcd1c70d8f4b1c7a5ffc3c?country=s4&count=10&type=ipv4
Если всё прошло успешно, в ответ поступит json следующего содержания:
{ "status": "ok", "purchase_id": "id" }
Внимание на поле "purchase_id", оно будет полезно для дальнейшего получения прокси. Данный "id" будет установлен в комментарий для купленных прокси. IPv4 прокси выдаются сразу, в случае покупки IPv6 прокси, раз в 30 секунд нужно чекать метод "get_proxies" с параметром "filter" равным значению этого "purchase_id". Как только в ответ будет выдаваться список с количеством элементов равному количеству заказанных прокси, то это будет означать, что выдача прокси завершена.
Помните, не стоит интегрировать API покупки напрямую в десктопный софт со своим захардкоженным реселлерским ключем. Это может привести к тому, что за ваш счет будут покупать себе прокси, делайте прослойку.
-
proxy_ids – список "id" прокси для продления, указывается в теле POST запроса, разделенных запятыми (пример: "13582,17371,17282" – в запросе без кавычек)
type – тип прокси IPv4 или IPv6 (нужно указывать лишь один)
country – страну для прокси IPv4 или IPv6 (можно продлевать лишь один тип)POST /api/renew/apikey?type=ipv4/ipv6&country= proxy_ids=proxy id list
Если всё прошло успешно, в ответ поступит json следующего содержания:
{ "status": "ok" }
-
type – тип прокси IPv4 или IPv6 (нужно указывать лишь один) в GET запросе к URL
comment – комментарий к прокси, в GET запросе к URL
proxy_ids – список "id" прокси для продления, указывается в теле POST запроса, разделенных запятыми (пример: "13582,17371,17282" – в запросе без кавычек)POST /api/set_comment/apikey?type=ipv4/ipv6&comment=example proxy_ids=proxy id list
Если всё прошло успешно, в ответ поступит json следующего содержания:
{ "status": "ok" }
-
type – тип прокси IPv4 или IPv6 (нужно указывать лишь один) в GET запросе к URL
status – "on" или "off", в зависимости от значения будет устанавливать или удалять привязку к IP (GET)
ip – ip адресс, на который нужно установить привязку в POST запросе к URL
proxy_ids – Cписок "id" прокси для продления, указывается в теле POST запроса, разделенных запятыми (пример: "13582,17371,17282" – в запросе без кавычек)POST /api/set_ipauth/apikey?type=ipv4/ipv6&status=on proxy_ids=proxy id list&ip=185.33.22.11
Если всё прошло успешно, в ответ поступит json следующего содержания:
{ "status": "ok" }