Описание API для партнеров и интеграций

Обновление 20/05/19

API для партнеров и пользователей приватных прокси-каналов

Для интеграции в ПО и автоматизации работы с мобильными прокси AIRSOCKS,
в нашем сервисе предусмотрены вызовы API возвращающие ответы в формате JSON

Получение списка прокси

Для этого достаточно использовать ссылку  https://dashboard.airsocks.in/partner?u=[username]&p=[password]

[username] = Логин от Личного кабинета
[password] = Пароль от Личного кабинета

Данные о прокси и ссылках для смены адреса (для приватных каналов) будут возвращены в формате JSON


Обновление от 20/05/19


Теперь JSON возвращает и оператора, гео, OS fingerprint и другую полезную информацию

Получение списка прокси возможно в трех разных версиях JSON, для выбора версии нужно указать дополнительно &v=v1 [&v=v2] [&v=v3]

Пример: https://dashboard.airsocks.in/partner?u=[username]&p=[password]&v=v3


Управление приватными каналами

Для управления сменой IP адреса и Passive TCP/IP OS fingerprint на приватных каналах мы создали три версии API, подберите наиболее удобный под свои задачи


Рекомендуемая версия API: 3


API v1 (Classic)

Возвращает ОК после успешной смены IP адреса/OS fingerprint, либо возвращает ошибку, если смена адреса уже идет или не может быть осуществлена.

Switch IP:

http://{proxy_hostname}/changer_channels/channel_{last_number_of_proxy_port}?session={session_key}

Switch FP:

http://{proxy_hostname}/changer_channels/channel_{last_number_of_proxy_port}?session={session_key}&fp={fp}


API v2 (Advanced, Status)

Принимает запрос на смену IP адреса/OS fingerprint, возвращает номер запроса и ссылки на проверку статуса, ответ выдается сразу, состояние запроса проверяется в endpoint "/status"

Endpoint "status", возвращает номер запроса, результат запроса, время запроса, а так же новый и старый IP адреса.

Switch IP:

http://{proxy_hostname}/api/v2/changer_channels/channel_{last_number_of_proxy_port}?session={session_key}

Status:

http://{proxy_hostname}/api/v2/changer_channels/channel_{last_number_of_proxy_port}/status?session={session_key}

Switch FP:

http://{proxy_hostname}/api/v2/changer_channels/channel_{last_number_of_proxy_port}?session={session_key}&fp={fp}

Status FP:

http://{proxy_hostname}/api/v2/changer_channels/channel_{last_number_of_proxy_port}/fp?session={session_key}


API v3 (Advanced, Json, Status)

Возвращает данные о смене адреса после успешной смены IP адреса/OS fingerprint, либо возвращает ошибку, если смена адреса уже идет или не может быть осуществлена.

Возможно получение данных в json, для этого к ссылке необходимо добавить &json=1

Дополнительно можно просматривать endpoint status, чтобы посмотреть состояние последнего вызова API

Switch IP:

http://{proxy_hostname}/api/v3/changer_channels/channel_{last_number_of_proxy_port}?session={session_key}

Switch FP:

http://{proxy_hostname}/api/v3/changer_channels/channel_{last_number_of_proxy_port}?session={session_key}&fp={fp}

Status:

http://{proxy_hostname}/api/v3/changer_channels/channel_{last_number_of_proxy_port}/status?session={session_key}


{proxy_hostname} -- адрес сервера, на котором расположен Ваш прокси, например me-pvt-x.airsocks.in

{last_number_of_proxy_port} - номер канала, номер канала соответствует последней цифре в номере порт прокси, например me-pvt-x.airsocks.in:12345
= 5

{session_key} --  уникальный ключ, генерируемый при создании канала, получить его можно в личном кабинете или через парнерский API


Для смены Passive OS Fingerprint (p0f) через API:

Необходимо к ссылке для смены адреса добавить &fp={fp}


Например, 

http://{proxy_hostname}/api/v3/changer_channels/channel_{last_number_of_proxy_port}?session={session_key}&fp={fp}


Значения OS Fingerprint, которые возможно установить:

&Установка Windows 7 или 8 (а так же Windows 8.1):
&fp=win

Установка Windows 7 или 8 [fuzzy], часто  встречается на Windows Server 2012
&fp=winfuzzy,

Установка Windows XP:
&fp=winxp  

Установка Android (Linux 2.2.x-3.x):
&fp=android  

Установка 'MacOS X [generic][fuzzy]' (MacBook / OSX / iPhone)
&fp=iosfuzzy

Установка 'MacOS X [generic]' менее популярный вариант для MacBook / OSX / iPhone
&fp=ios

Установка 'Windows NT [generic]' что является самой распространенной на данной момент ОС Windows 10 / Windows 2016 Server.
&fp=ntgeneric

Установка 'Windows NT [generic][fuzzy]' один из вариантов Windows 10 / Windows 2016 Server.
&fp=ntfuzzy

Установка '???' в системах определения. Иными словами, Passive OS Fingerprint (TCP/IP) будет скрыт.
&fp=unknown  

Установка 'Linux 3.11 and newer' последние версии операционных систем на базе ядра Linux:
&fp=linux



Новости

Отличие мобильных прокси от серверных прокси IPv4

Читать далее >

FAQ

Читать далее >

Как настроить Proxifier для использования с мобильными прокси AIRSOCKS на OSX ( Mac )

Читать далее >