API description for partners and integrations

Update 20/05/19


API for partners and users of private proxy channels


For integration into software and automation of work with mobile proxies AIRSOCKS,

Our service provides API calls that return responses in JSON format.


Getting proxy list

To do this, simply use the link https://dashboard.airsocks.in/partner?u=[usernamey&p=[password]


[username] = Login from the Personal Account

[password] = Password from the Personal Account


Information about proxies and links for changing the address (for private channels) will be returned in JSON format


Update from 20/05/19


Now JSON returns and operator, geo, OS fingerprint and other useful information

Obtaining a list of proxies is possible in three different versions of JSON, to select a version, you must specify &v=v1 [&v=v2] [&v=v3]

Example: https://dashboard.airsocks.in/partner?u=[username]&p=[password]&v=v3



Private Channel Management

To manage the change of IP address and Passive TCP / IP OS fingerprint on private channels, we created three versions of the API, select the most convenient one for your tasks.


Recommended API version: 3

API v1 (Classic)

It returns OK after a successful change of the IP address / OS fingerprint, or returns an error if the address change is already underway or cannot be made.

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)

Accepts a request to change the IP address / OS fingerprint, returns the request number and a link to the status check, the response is issued immediately, the status of the request is checked at the endpoint "/ status"

Endpoint "status", returns the request number, the result of the request, the time of the request, as well as the new and old IP addresses.


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)

It returns data about changing the address after successfully changing the IP address / OS fingerprint, or returns an error if the address change is already underway or cannot be made.

It is possible to get data in json, for this you need to add & json = 1 to the link


Additionally, you can view the endpoint status to see the status of the last API call.


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} - address of the server where your proxy is located, for example me-pvt-x.airsocks.in

{last_number_of_proxy_port} - channel number, channel number corresponds to the last digit in the proxy port number, for example me-pvt-x.airsocks.in:12345

= 5

{session_key} - a unique key generated when creating a channel, you can get it in your account or through the partner API


To change Passive OS Fingerprint (p0f) via API:

It is necessary to add to the link to change the address & fp = {fp}


For example,

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

OS Fingerprint values that can be set:

Install Windows 7 or 8 (and Windows 8.1):
&fp=win

Installing Windows 7 or 8 [fuzzy] is common on Windows Server 2012
&fp=win fuzzy,

Install Windows XP:
&fp=winxp  

Install Android (Linux 2.2.x-3.x):
&fp=android  

Install 'Mac OS X [generic][fuzzy]' (MacBook / OS X / iPhone)
&fp=isfuzzy

Install 'MacOS X [generic]' less popular option for MacBook / OS X / iPhone
&fp=ios

Install 'Windows NT [generic]' which is the most common OS currently Windows 10 / Windows 2016 Server.
&fp=net generic

Installing 'Windows NT [generic][fuzzy]' is an option for Windows 10 / Windows 2016 Server.
&fp=ntfuzzy

Installation '???'in the system definition. In other words, Passive OS Fingerprint (TCP/IP) will be hidden.
&fp=unknown

News

The differences between mobile proxies and IPv4 server proxies

Read more >

FAQ

Read more >

How to configure Proxifier for use with mobile proxies AIRSOCKS on OSX (Mac)

Read more >