Работа с нашим API

Если вы занимаетесь перепродажей, вы обязаны:

Уведомлять пользователей о правилах использования прокси. О том, что прокси подходят только для легальных целей.

Хранить проверенный email и IP адрес пользователей. IP совершенных оплат. В случае нарушения правил аккаунт будет заблокирован.

Текст, который вы обязаны показывать пользователям перед заказом:

Наши прокси подходят только для белых целей

Авторизация

Ваш API-key
yourapikeyyourapikey
Для авторизации необходимо в каждом запросе передавать ваш api-key. Это можно сделать, добавив в запрос параметр api_key равный вашему ключу, либо передать заголовок API-KEY.

Ограничения

Максимальное количество запросов за минуту — 50.

Страны

  • ru - Russia
  • de - Germany
  • us - USA
  • nl - Netherland
  • gb - United Kingdom
  • ca - Canada
  • es - Spain
  • it - Italy
  • id - Indonesia
  • fr - France
  • ch - Switzerland
  • pt - Portugal
  • ua - Ukraine
  • kz - Kazakhstan
  • cn - China
  • pl - Poland
  • in - India
  • jp - Japan
  • al - Albania
  • dz - Algeria
  • ar - Argentina
  • am - Armenia
  • au - Australia
  • at - Austria
  • az - Azerbaijan
  • bd - Bangladesh
  • by - Belarus
  • be - Belgium
  • bo - Bolivia
  • ba - Bosnia and Herzegovina
  • br - Brazil
  • bg - Bulgaria
  • kh - Cambodia
  • cm - Cameroon
  • cl - Chile
  • co - Colombia
  • cr - Costa Rica
  • hr - Croatia
  • cy - Cyprus
  • cz - Czech Republic
  • dk - Denmark
  • eg - Egypt
  • ee - Estonia
  • fi - Finland
  • ge - Georgia
  • gr - Greece
  • hk - Hong Kong
  • hu - Hungary
  • is - Iceland
  • ir - Iran
  • iq - Iraq
  • ie - Ireland
  • il - Israel
  • jm - Jamaica
  • jo - Jordan
  • ke - Kenya
  • kg - Kyrgyzstan
  • lv - Latvia
  • lt - Lithuania
  • lu - Luxembourg
  • my - Malaysia
  • mv - Maldives
  • mt - Malta
  • mx - Mexico
  • md - Moldova
  • mc - Monaco
  • mn - Mongolia
  • me - Montenegro
  • ma - Morocco
  • nz - New Zealand
  • ng - Nigeria
  • no - Norway
  • pk - Pakistan
  • pe - Peru
  • ph - Philippines
  • qa - Qatar
  • ro - Romania
  • sa - Saudi Arabia
  • rs - Serbia
  • sc - Seychelles
  • sg - Singapore
  • sk - Slovakia
  • si - Slovenia
  • za - South Africa
  • kr - South Korea
  • lk - Sri Lanka
  • se - Sweden
  • tw - Taiwan
  • tj - Tajikistan
  • tz - Tanzania
  • th - Thailand
  • tn - Tunisia
  • tr - Turkey
  • tm - Turkmenistan
  • ae - United Arab Emirates
  • uy - Uruguay
  • uz - Uzbekistan
  • ve - Venezuela
  • vn - Vietnam
 

Методы

proxies

Метод для получения списка прокси.
https://my.onlyproxy.com/api/proxies/?api_key=yourapikeyyourapikey

Параметры:

  • status — статус прокси: active, expired, deleted. По умолчанию показываются все.
  • type — тип прокси: dedicated или shared
  • ip_version — версия IP: 4 или 6
  • country — код страны, страны. Можно указать несколько раз. country=en&country=ru
  • date_after, date_before — дата покупки, нижняя и верняя границы. Формат 2018-10-25. Включает указаный день.
  • date_end_after, date_end_before — дата окончания заказа, нижняя и верняя границы. Формат 2018-10-25. Включает указаный день.
  • orders — ID заказа. Можно указать несколько раз.
  • format — Формат получения ответа. Можно указать txt-http или txt-socks5 для получния списка прокси в текстовом виде. Либо custom-http или custom-socks5 для использования произвольного формата из настроек.
  • limit — лимит прокси в списке. По умолчанию 500. Максимум 2000.
  • offset — Сдвиг пагинации.

orders

Метод для получения списка заказов.
https://my.onlyproxy.com/api/orders/?api_key=yourapikeyyourapikey

Параметры:

  • date_after, date_before — дата покупки, нижняя и верняя границы. Формат 2018-10-25. Включает указаный день.

renew

Продление прокси. Оплата со счета. Метод POST.
https://my.onlyproxy.com/api/renew/?api_key=yourapikeyyourapikey

Параметры:

  • proxies — id прокси, которые необходимо продлить. Множество значений под одним и тем же ключом (proxies=1&proxies=2&proxies=3).
  • period — 5, 10, 20, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330, 360
  • coupon — код купона на скидку

new-order

Создание нового заказа. Оплата со счета. Метод POST.
https://my.onlyproxy.com/api/new-order/?api_key=yourapikeyyourapikey

Параметры:

  • type — тип прокси: dedicated или shared (если IPv6, тогда только dedicated)
  • ip_version — версия IP: 4 или 6
  • country — код страны, страны
  • quantity — количество
  • period — 5, 10, 20, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330, 360
  • coupon — код купона на скидку
  • ip_list — id IP, который вы хотите заказать, можно получить в методе ips. Можно указать несколько раз.

countries

Получить список стран с вложенными городами. Код страны и ID города можно использовать для фильтрации
https://my.onlyproxy.com/api/countries/?api_key=yourapikeyyourapikey

ips

Получить список IP по параметрам. ID используются в методах создания заказа и продления.
https://my.onlyproxy.com/api/ips/?api_key=yourapikeyyourapikey&ip_version=4&type=dedicated&country=ru

Параметры:

type, ip_version, country — обязательны
  • type — тип прокси: dedicated или shared (если IPv6, тогда только dedicated)
  • ip_version — версия IP: 4 или 6
  • country — код страны, страны
  • city — ID города. Можно получить в методе countries

ips-count

Получить количество IP по параметрам. Если количество больше 1000, будет показано как 1000.
https://my.onlyproxy.com/api/ips-count/?api_key=yourapikeyyourapikey&ip_version=4&type=dedicated&country=ru

Параметры:

Такие же, как в методе ips. Все параметры обязательны

new-order-amount

Получение суммы заказа до оплаты. Метод POST.
https://my.onlyproxy.com/api/new-order-amount/?api_key=yourapikeyyourapikey
Такие же, как в методе new-order.

balance

Получение остатка на балансе. Обычном и партнерском.
https://my.onlyproxy.com/api/balance/?api_key=yourapikeyyourapikey