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

Дневник админа
Разработчикам (API)

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

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

Связь партнеров с системой и связь между системой и партнерами осуществляется с помощью запросов GET и ответов JSON. Все коммуникации происходят в кодировке UTF-8 , ответ в другой кодировке может привести к сбоям.

Вызовите API по следующему адресу : < br>

 https://proxy6.net/api/ {api_key} / {method} /?  {params}  

api_key — Секретный ключ, вы можете получить его в своем аккаунте; method — название одного из методов; params — дополнительные параметры запроса в зависимости от метода. Подумайте. Разрешено делать не более 3 запросов в секунду к API. Если лимит превышен, для лишних запросов будет возвращена ошибка 503.

 

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

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

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

 

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

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

 

 

 

 {
 "status": "no", 
 "error_id": 100, 
 "error": "Error key" 
} 

status - Всегда " нет ", если ошибочный ответ; error_id - Номер ошибки; error - Описание ошибки.

 

 

Метод "getprice"

 

 

 https://proxy6.net/api/ {api_key} / getprice ?  count  = 100 & amp;  период  = 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_single - Стоимость одного прокси; period - Запрошенный период (кол-во дней); count - Запрошенное кол-во прокси.

 

 

 

Метод "getcount"

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

Параметры метода:

 

https://proxy6.net/api/ {api_key} / getcount ? country = en

В приведенном выше примере мы получаем количество российских прокси IPv6, доступных для покупки.
Если ответ положительный:

 

 

 

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

count - доступное количество.

 

Метод getcountry

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

Параметры метода:.
<Предварительно> https://proxy6.net/api/<сильный> {api_key} /<сильный> Getcountry ? <Сильный> Версия = 4 .
Если ответ положительный:

<бр <Предварительно> {
"Статус": "Да",
"user_id": "1",
"Баланс": "48.80",
"Валюта": "руб", <бр > "список": [ "RU", "UA", "США"]
} LIST - массив доступных стран в формате ISO2.

 

<сильный> Метод. "Getproxy"

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

<сильный> Параметры метода:.
<Код> Состояние - Состояние & NBSP; возвращаемые прокси. Доступные значения: <сильный> Активный - Активные, Истекло & NBSP; - Неактивные, <сильный> Освобождающиеся - заканчивающиесяя, <сильный> все - все (по-умолчанию); <Код> DESCR - Технический комментарий, который вы указывали при покупке прокси. Если данный параметр присутствует, то будут выбраны только те прокси, у которых присутствует данный комментарий, если же данный параметр не задан, то будут выбраны все прокси; <Код> NOKEY - При добавлении данного параметра (значение не требуется), Список <код> список будет возвращаться без ключей. <Предварительно> https://proxy6.net/api/<сильный> {api_key} /<сильный> getproxy
В случае успешного ответа: Аренда на отпуск <Предварительно> {
"статус": "Да",
"user_id": "1",
"Баланс": "48.80",
"Валюта": "руб",
"List_Count": 4,
"Буква": {
"11": {
"ID": "11",
"IP": «2a00: 1 838: 32: 19f: 45FB: 2640 :: 330 "
" Host ":" 185.22.134.250 "
" Порт ":" 7330 "
" Пользователь ":" 5svbnz "
" Pass «: "Iign2D",
"Тип": "HTTP",
"Страна": "RU",
"Дата": "2016-06-19 16:32:39",
" date_end ":" 2016-07-12 11:50:41 "
" UnixTime ": 1466379159,
" Unixtime_end ": 1468349441,
" desecr ":" "
" Активный ": "1"
},
"14" { "
" ИД ":" 14 "
" IP ":" 2a00: 1838: 32: 198: 56EC: 2696 :: 386 "
"Host": "185.22.134.242",
"Порт": "7386",
"Пользователь": "NV5TFK",
"Pass": "3itr1t",
" Тип ": "HTTP",
"Страна": "RU",
"Дата": "2016-06-27 16:06:22",
"date_end":" 2016-07 - 11 16:06:22 "
" UnixTime ": 1466379159,
" Unixtime_end ": 1468349441,
" DESCR ":" "
" Активный ":" 1 «
} < ш>}
LIST_COUNT - количество прокси-серверов; <Код> List - Proxy доска; <КОД> ID - внутренний номер представителя, необходимый для расширения - метод <код> расширение <Код> IP - IPv4 или IPv6 скрыт для хоста: порт - зависит от прокси-версии; <Код> Хост - IPv4; <Код> порт - порт; <Код> Пользователь - Логин; <Код> передача - пароль; <Код> Тип - Тип прокси: HTTP - протокол HTTPS, носки - socks5; <Код> Страна - Страна (ISO2); <Код> Дата - Дата покупки прокси; <Код> date_end - Дата окончания срока действия прокси; DESCR - Технический комментарий; <Код> Активный - активный (<сильный> 1 ) или нет (<сильный> 0 ).

 

<сильный> Метод "SetType"

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

<сильный> Параметры метод:.
<Код> IDS & NBSP; - ( обязательный ) - перечень внутрених номеров прокси в нашей системе, через запятую; <Код> Тип & NBSP; - ( обязательный ) - устанавливаемый тип (протокол): <сильный> HTTP - протокол HTTPS, либо Носки - Socks5. <Предварительно> https://proxy6.net/api/<сильный> {api_key} /<сильный> SetType ? <Сильный> IDS = 10,11,12,15 & усилитель <сильный> Тип = носки
в примере выше мы изменяем тип прокси с номерами 10,11,12,15 & NBSP; на socks5
В случае успешного ответа:.

<Предварительно> {
"статус": "Да",
"user_id": "1",
"Баланс": "48.80",
"Валюта": "руб"
}
если @nbsp, метод успешно изменяет методне возвращает никаких новых данных в ответе.
Если ВСЕ прокси, тип которых вы хотите изменить (переданный параметром ids), уже имеют соответствующий тип (протокол), будет возвращен номер ошибки 30 (Ошибка неизвестна). < br>

Метод setdescr

 

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

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

 

 

 https://proxy6.net/api/ {api_key} / setdescr ?  старый  = test & amp;  новый  = newtest 

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

 

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

 

 

Метод «купить»

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

Параметры метода:
count - ( Обязательный ) - Кол-во прокси для покупки; period - ( Обязательный ) - Период на который покупаются прокси - кол-во дней; country - ( Обязательный ) - Страна в формате iso2; версия - & nbsp; Версия прокси: 4 - IPv4, 3 - общий IPv4, 6 - IPv6 (< strong> по-умолчанию ); тип - Тип прокси (протокол): socks , либо http ( по-умолчанию ); descr - Технический протокол для списка прокси, максимальная длина 50 символов. auto_prolong - при добавлении этого параметра (значение не требуется) для приобретенных прокси будет включено автоматическое продление; nokey - добавление этого параметра (значение не требуется) приведет к тому, что list будет возвращен без ключей.

 

 https://proxy6.net/api/ {api_key} / купить ?  count  = 1 & amp;  период  = 7 & amp;  country  = ru 

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

 "status": "yes", 
 "user_id": "1", 
 "balance": 42,5, 
 "currency": "RUB", 
 " count ": 1, 
" price ": 6.3, 
" price_single ": 0.9, 
" period ": 7, 
" country ":" ru ", 
" list ": {
 "15": {
 "id": "15", 
 "ip": "2a00: 1838: 32: 19f: 45fb: 2640 :: 330", 
 "host" : "185.22.134.250", 
 "порт": "7330", 
 "пользователь": "5svBNZ", 
 "проход": "iagn2d", 
 "тип": "http" , 
 «date»: «2016-06-19 16:32:39», 
 «date_end»: «2016-07-12 11:50:41», 
 «unixtime»: 1466379159, 
 "unixtime_end": 1468349441, 
 "active": "1" 
} 
} 
} 

count - & nbsp; Запрошенное кол-во прокси для покупки; цена - & nbsp; Итоговая стоимость; price_single - Стоимость одного прокси для кол-ва и периода; period - Запрошенный период для покупки (кол-во дней); country - Локация (страна) прокси для покупки в формате iso2; list & nbsp; - Массив купленных прокси; id - Внутренний номер прокси, необходим для продления & nbsp; срока действия - метод продлить ip - IPv6 скрытый за host: port; хост - IPv4; порт - Порт; пользователь - Логин; пройти - Пароль; type - Тип прокси: http - HTTPS, socks - SOCKS5; date - Дата покупки прокси; date_end - Дата окончания срока действия прокси; active - Активный (1) или нет (0).

 

Метод "extend". Используется для расширения текущего прокси.

Параметры метода:
период - ( Привязка ) - Период продления - количество дней; ids - ( Привязка ) - список номеров внутренних прокси в нашей системе, разделенных запятыми; nokey - если этот параметр добавлен (значение не требуется), list будет возвращен без ключей.

 https://proxy6.net/api/ {api_key} / продлить ?  период  = 7 & amp;  ids =  15,16 

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

{

 "status": "yes", 
 "user_id": "1", 
 "balance": 29, 
 "currency": "RUB", 
 " price ": 12.6", 
 "price_single": 0.9, 
 "period": 7, 
 "count": 2, 
 "list": {
 "15": {
 "id": 15, 
 "date_end":
"2016-07-15 06:30:27", 
 "unixtime_end": 1466379159 
}, 
 "16": {
 "id": 16, 
 "date_end": «16 июля 2016 г., 09:31:21», 
 «unixtime_end»: 1466379261 
} 
} 
} 

цена - Итоговая стоимость продления; price_single - & nbsp; Стоимость одного прокси для кол-ва и периода (отсутствует при продлен) period - & nbsp; Запрошенный период для продления & nbsp; (кол-во дней); count - Кол-во успешных продлений; list - Массив продленных прокси; id - & nbsp; Внутренний номер прокси; date_end - Новая дата окончания срока действия прокси.

 

Метод «удалить»

 

 

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

Параметры метода:
ids - ( Обязательный ) - & nbsp; Перечень внутренних номеров прокси в намеров прокси в назатея систереме систетей систетей систетей систе descr - ( Обязательный ) - Технический комментарий, который вы указывали при порексcode подрумеке порумекеcode. Обязательно должен присутствовать один из параметров, либо 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 - количество удаленных прокси.

 

Метод «проверки». Он используется для проверки прокси.

Параметры метода:
ids - ( Привязка ) - внутренний номер прокси в нашей системе.

 https://proxy6.net/api/{ api_key }/ check ?  ids  = 15 
Разработчикам (API)

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

 

 {
 "status": "yes", 
 "user_id": "1", 
 "balance": "48.80", 
 "currency": "RUB", 
 "proxy_id": 15, 
 "proxy_status": true 
} 

proxy_id & nbsp; - внутренний номер прокси; proxy_status - результат проверки: истина или ложь.

 

Оцените статью