Примерное время прочтения: 5 мин
Обновление 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
Источник статьи: https://airsocks.in/knowledge/post/api-description-partners-and-integrations