Разработчикам (API)

Api позволит вам интегрировать покупку и продление прокси в ваш сервис, либо приложение.

Взаимодействие партнера с системой, равно как и системы с партнером происходит посредством GET запросов и JSON ответов. Все общение происходит в кодировке UTF-8, ответ полученный в другой кодировке может привести к ошибкам в работе.

Обращение к API производится по адресу:

https://proxy6.net/api/{api_key}/{method}/?{params}
  • api_key - Секретный ключ, вы можете получить его в личном кабинете;
  • method - Название одного из методов;
  • params - Дополнительные параметры запроса в зависимости от метода.
Внимание. К API разрешено делать не более 3-х запросов в 1 секунду. При превышении лимита будет возвращаться ошибка 503 на лишние запросы.

Доступные методы:

  • getprice - Получение информации о сумме заказа;
  • getcount - Получение информации о доступном кол-ве прокси для конкретной страны;
  • getcountry - Получение списка доступных стран;
  • getproxy - Получение списка ваших прокси;
  • settype - Изменение типа (протокола) прокси;
  • setdescr - Обновление технического комментария;
  • buy - Покупка прокси;
  • prolong - Продление списка прокси;
  • delete - Удаление прокси;
  • check - Проверка валидности прокси.
  • ipauth - Привязка/удаление авторизации прокси по ip.
При обращении к любому методу api, либо к api без метода (только с ключом: https://proxy6.net/api/{api_key}), в ответе всегда будут присутствовать следующие значения:

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

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB"
}
  • status - Всегда "yes", если успешный ответ и не возникло ошибок;
  • user_id - Номер вашего аккаунта;
  • balance - Текущее состояние вашего баланса;
  • currency - Валюта вашего аккаунта (RUB, либо USD).
Ошибочный ответ:

{
 "status": "no",
 "error_id": 100,
 "error": "Error key"
}
  • status - Всегда "no", если ошибочный ответ;
  • error_id - Номер ошибки;
  • error - Описание ошибки.

Метод "getprice"

Используется для получения информации о сумме заказа в зависимости от версии, периода и кол-ва прокси.

Параметры метода:
  • count - (Обязательный) - Кол-во прокси;
  • period - (Обязательный) - Период - кол-во дней;
  • version - Версия прокси: 4 - IPv4, 3 - IPv4 Shared, 6 - IPv6 (по-умолчанию).
https://proxy6.net/api/{api_key}/getprice?count=100&period=30

В примере выше мы получаем информацию о стоимости 100 IPv6 прокси на 30 дней.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB",
 "price": 1800,
 "price_single": 0.6,
 "period": 30,
 "count": 100
}
  • price - Итоговая стоимость;
  • price_single - Стоимость одного прокси;
  • period - Запрошенный период (кол-во дней);
  • count - Запрошенное кол-во прокси.

Метод "getcount"

Используется для получения информации о доступном для приобретения кол-ве прокси определенной страны.

Параметры метода:
  • country - (Обязательный) - Код страны в формате iso2;
  • version - Версия прокси: 4 - IPv4, 3 - IPv4 Shared, 6 - IPv6 (по-умолчанию).
https://proxy6.net/api/{api_key}/getcount?country=ru

В примере выше мы получаем информацию о доступном для приобретения кол-ве российских IPv6 прокси.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB",
 "count": 971
}
  • count - Доступное кол-во.

Метод "getcountry"

Используется для получения информации о доступных для приобретения странах.

Параметры метода:
  • version - Версия прокси: 4 - IPv4, 3 - IPv4 Shared, 6 - IPv6 (по-умолчанию).
https://proxy6.net/api/{api_key}/getcountry?version=4

В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB",
 "list": ["ru","ua","us"]
}
  • list - Массив доступных стран в формате iso2.

Метод "getproxy"

Используется для получения списка ваших прокси.

Параметры метода:
  • state - Состояние возвращаемых прокси. Доступные значения: active - Активные, expired - Неактивные, expiring - Заканчивающиеся, all - Все (по-умолчанию);
  • descr - Технический комментарий, который вы указывали при покупке прокси. Если данный параметр присутствует, то будут выбраны только те прокси, у которых присутствует данный комментарий, если же данный параметр не задан, то будут выбраны все прокси;
  • nokey - При добавлении данного параметра (значение не требуется), список list будет возвращаться без ключей;
  • page - Номер страницы для вывода. 1 - по-умолчанию;
  • limit - Кол-во прокси для вывода в списке. 1000 - по-умолчанию (максимальное значение).
https://proxy6.net/api/{api_key}/getproxy

В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB",
 "list_count": 4,
 "list": {
   "11": {
      "id": "11",
      "ip": "2a00:1838:32:19f:45fb:2640::330",
      "host": "185.22.134.250",
      "port": "7330",
      "user": "5svBNZ",
      "pass": "iagn2d",
      "type": "http",
      "country": "ru",
      "date": "2016-06-19 16:32:39",
      "date_end": "2016-07-12 11:50:41",
      "unixtime": 1466379159,
      "unixtime_end": 1468349441,
      "descr": "",
      "active": "1"
   },
   "14": {
      "id": "14",
      "ip": "2a00:1838:32:198:56ec:2696::386",
      "host": "185.22.134.242",
      "port": "7386",
      "user": "nV5TFK",
      "pass": "3Itr1t",
      "type": "http",
      "country": "ru",
      "date": "2016-06-27 16:06:22",
      "date_end": "2016-07-11 16:06:22",
      "unixtime": 1466379159,
      "unixtime_end": 1468349441,
      "descr": "",
      "active": "1"
   }
 }
}
  • list_count - Кол-во прокси (на странице);
  • list - Массив прокси;
    • id - Внутренний номер прокси, необходим для продления срока действия - метод prolong
    • ip - IPv4, либо IPv6 скрытый за host:port - зависит от версии прокси;
    • host - IPv4;
    • port - Порт;
    • user - Логин;
    • pass - Пароль;
    • type - Тип прокси: http - HTTPS, socks - SOCKS5;
    • country - Страна (iso2);
    • date - Дата покупки прокси;
    • date_end - Дата окончания срока действия прокси;
    • descr - Технический комментарий;
    • active - Активный (1) или нет (0).

Метод "settype"

Используется для изменения типа (протокола) у списка прокси.

Параметры метода:
  • ids - (Обязательный) - Перечень внутренних номеров прокси в нашей системе, через запятую;
  • type - (Обязательный) - Устанавливаемый тип (протокол): http - HTTPS, либо socks - SOCKS5.
https://proxy6.net/api/{api_key}/settype?ids=10,11,12,15&type=socks

В примере выше мы изменяем тип прокси с номерами 10,11,12,15 на SOCKS5.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB"
}

В случае успешного изменения типа, метод не возвращает в ответе никаких новых данных.
В случае, если ВСЕ прокси, у которых вы хотите изменить тип (переданные через параметр ids), уже имеют соответствующий тип (протокол), то вернется ошибочный ответ с номером 30 (Error unknown).


Метод "setdescr"

Используется для обновления технического комментария у списка прокси, который был установлен при покупке (метод buy).

Параметры метода:
  • new - (Обязательный) - Технический комментарий, на который нужно изменить. Максимальная длина 50 символов;
  • old - Технический комментарий, который нужно изменить;
  • ids - Перечень внутренних номеров прокси в нашей системе, через запятую.
Обязательно должен присутствовать один из параметров, либо ids, либо old.

https://proxy6.net/api/{api_key}/setdescr?old=test&new=newtest

В примере выше мы изменяем комментарий с test на newtest.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB",
 "count": 4
}
  • count - Кол-во прокси у которых был изменен комментарий.

Метод "buy"

Используется для покупки прокси.

Параметры метода:
  • count - (Обязательный) - Кол-во прокси для покупки;
  • period - (Обязательный) - Период на который покупаются прокси - кол-во дней;
  • country - (Обязательный) - Страна в формате iso2;
  • version - Версия прокси: 4 - IPv4, 3 - IPv4 Shared, 6 - IPv6 (по-умолчанию);
  • type - Тип прокси (протокол): socks, либо http (по-умолчанию);
  • descr - Технический комментарий для списка прокси, максимальная длина 50 символов. Указание данного параметра позволит вам делать выборку списка прокси про этому параметру через метод getproxy
  • auto_prolong - При добавлении данного параметра (значение не требуется), у купленных прокси будет включено автопродление;
  • nokey - При добавлении данного параметра (значение не требуется), список list будет возвращаться без ключей.
https://proxy6.net/api/{api_key}/buy?count=1&period=7&country=ru

В примере выше мы покупаем 1 российский IPv6 прокси на 7 дней.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": 42.5,
 "currency": "RUB",
 "count": 1,
 "price": 6.3,
 "period": 7,
 "country": "ru",
 "list": {
   "15": {
      "id": "15",
      "ip": "2a00:1838:32:19f:45fb:2640::330",
      "host": "185.22.134.250",
      "port": "7330",
      "user": "5svBNZ",
      "pass": "iagn2d",
      "type": "http",
      "date": "2016-06-19 16:32:39",
      "date_end": "2016-07-12 11:50:41",
      "unixtime": 1466379159,
      "unixtime_end": 1468349441,
      "active": "1"
   }
 }
}
  • count - Запрошенное кол-во прокси для покупки;
  • price - Итоговая стоимость;
  • price_single - Стоимость одного прокси для указанного кол-ва и периода;
  • period - Запрошенный период для покупки (кол-во дней);
  • country - Локация (страна) прокси для покупки в формате iso2;
  • list - Массив купленных прокси;
    • id - Внутренний номер прокси, необходим для продления срока действия - метод prolong
    • ip - IPv6 скрытый за host:port;
    • host - IPv4;
    • port - Порт;
    • user - Логин;
    • pass - Пароль;
    • type - Тип прокси: http - HTTPS, socks - SOCKS5;
    • date - Дата покупки прокси;
    • date_end - Дата окончания срока действия прокси;
    • active - Активный (1) или нет (0).

Метод "prolong"

Используется для продления текущих прокси.

Параметры метода:
  • period - (Обязательный) - Период продления - кол-во дней;
  • ids - (Обязательный) - Перечень внутренних номеров прокси в нашей системе, через запятую;
  • nokey - При добавлении данного параметра (значение не требуется), список list будет возвращаться без ключей.
https://proxy6.net/api/{api_key}/prolong?period=7&ids=15,16

В примере выше мы продляем прокси с номерами 15 и 16 на 7 дней.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": 29,
 "currency": "RUB",
 "price": 12.6,
 "period": 7,
 "count": 2,
 "list": {
   "15": {
      "id": 15,
      "date_end": "2016-07-15 06:30:27",
      "unixtime_end": 1466379159
   },
   "16": {
      "id": 16,
      "date_end": "2016-07-16 09:31:21",
      "unixtime_end": 1466379261
   }
 }
}
  • price - Итоговая стоимость продления;
  • price_single - Стоимость одного прокси для указанного кол-ва и периода (отсутствует при продлении смешанного типа прокси);
  • period - Запрошенный период для продления (кол-во дней);
  • count - Кол-во успешных продлений;
  • list - Массив продленных прокси;
    • id - Внутренний номер прокси;
    • date_end - Новая дата окончания срока действия прокси.

Метод "delete"

Используется для удаления прокси.

Параметры метода:
  • ids - (Обязательный) - Перечень внутренних номеров прокси в нашей системе, через запятую;
  • descr - (Обязательный) - Технический комментарий, который вы указывали при покупке прокси, либо через метод setdescr.
Обязательно должен присутствовать один из параметров, либо ids, либо descr.

https://proxy6.net/api/{api_key}/delete?ids=15,16

В примере выше мы удаляем прокси с номерами 15 и 16.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB",
 "count": 4
}
  • count - Кол-во удаленных прокси.

Метод "check"

Используется для проверки валидности (работоспособности) прокси.

Параметры метода:
  • ids - (Обязательный) - Внутренний номер прокси в нашей системе.
https://proxy6.net/api/{api_key}/check?ids=15

В примере выше мы проверяем прокси с номером 15.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB",
 "proxy_id": 15,
 "proxy_status": true
}
  • proxy_id - Внутренник номер прокси;
  • proxy_status - Результат проверки: true или false.

Метод "ipauth"

Используется для привязки, либо удаления авторизации прокси по ip.

Параметры метода:
  • ip - (Обязательный) - Список привязываемых ip-адресов через запятую, либо "delete" -  для удаления привязки.
https://proxy6.net/api/{api_key}/ipauth?ip=45.155.202.18,31.121.11.123

В примере выше мы привязываем ip: 45.155.202.18, 31.121.11.123 ко всем своим прокси.
В случае успешного ответа:

{
 "status": "yes",
 "user_id": "1",
 "balance": "48.80",
 "currency": "RUB"
}

В случае успешной привязки/удаления, метод не возвращает в ответе никаких новых данных.

Коды ошибок


30 - Error unknown - Неизвестная ошибка
100 - Error key - Ошибка авторизации, неверный ключ 
105 - Error ip - Доступ к API произошел с неверного IP (если включено ограничение), либо некорректный формат IP адреса
110 - Error method - Ошибочный метод 
200 - Error count - Ошибка кол-ва прокси, неверно указано кол-во, либо отсутствует
210 - Error period - Ошибка периода, неверно указано кол-во (дней), либо отсутствует
220 - Error country - Ошибка страны, неверно указана страна (страны указываются в формате iso2), либо отсутствует
230 - Error ids - Ошибка списка номеров прокси. Номера прокси должны быть указаны через запятую
240 - Error version - Некорректно указана версия прокси
250 - Error descr - Ошибка технического комментария, неверно указан, либо отсутствует
260 - Error type - Ошибка типа (протокола) прокси, неверно указан, либо отсутствует
300 - Error active proxy allow - Ошибка кол-ва прокси. Возникает при попытке покупки большего кол-ва прокси, чем доступно на сервисе
400 - Error no money - Ошибка баланса. На вашем балансе отсутствуют средства, либо их не хватает для покупки запрашиваемого кол-ва прокси
404 - Error not found - Ошибка поиска. Возникает когда запрашиваемый элемент не найден
410 - Error price - Ошибка расчета стоимости. Итоговая стоимость меньше, либо равна нулю