get Return proxy.
/api/client/v1/proxies/{id}
Retrieve detailed information for a single proxy. This request could be used to obtain proxy ID, login, password, IP address, location, protocol (HTTP, SOCKS5, etc.), and other relevant metadata. It also includes information on proxy rotation and its expiration date.
Parameters
id
Required
Proxy ID. The response will contain data for the specified proxy, identified by its ID, which is generated by the OnlineProxy server upon purchase.
In:
path
Schema:
- integer:int64Example:
1
Responses
200
OK. A successful server response returns detailed information about the specified proxy.
Content Type:
application/json
- Schema
- Example
- objectProxyResourceExample:
{"id":1,"login":"string","password":"string","protocol":"http","host":"string","port":8080,"geo_country":"RU","geo_city":"Moscow","geo_operator":"mts","private":true,"comment":"string","rotate_ip_url":"string","rotate_ip_freq":5,"start_at":"2019-08-24T14:15:22Z","stop_at":"2019-08-24T14:15:22Z"}
Properties:id
integer:int64Order ID, generated by the OnlineProxy server upon purchasing the proxy.Example:1
login
string or nullLogin, use it to connect to the proxy server.Example:"string"
Maximum number of items:255
password
string or nullPassword, use it to connect to the proxy server.Example:"string"
Maximum number of items:255
protocol
stringThe protocol type required to connect to the proxy server.Example:"http"
Enum:http
socks5
host
stringHost or IP address of a proxy server.Example:"string"
Maximum number of items:255
port
integerPort of a proxy server.Example:8080
geo_country
stringThe country of origin of the proxy server. Country codes are in ISO 3166-1 alpha-2 format.
Example:"RU"
geo_city
string or nullCity name where proxy server is located.Example:"Moscow"
Maximum number of items:255
geo_operator
string or nullName of the operator of the proxy server.Example:"mts"
Maximum number of items:255
private
booleanProxy typeExample:true
comment
string or nullComment assigned to the current proxy (if any).Example:"string"
Maximum number of items:255
rotate_ip_url
string or nullURL for IP address rotationExample:"string"
rotate_ip_freq
integerIP address rotation frequency in minutes (0 - disabled)Example:5
<= 60
>= 0
start_at
string:date-timeOrder start datetime UTC ISO-8601
Example:"2019-08-24T14:15:22Z"
stop_at
string:date-timeOrder expire datetime UTC ISO-8601
Example:"2019-08-24T14:15:22Z"
401
Unauthorized. Missing or invalid authentication token, please check the Authorization header.
Content Type:
application/json
- Schema
- Example
- objectErrorResponseExample:
{"message":"string","errors":{}}
Properties:message
stringRequiredError messageExample:"string"
errors
object or nullInput validation errorsExample:{}
403
Forbidden. API access denied. Please check your Account settings to ensure that API access is enabled and your IP address is listed in the Access IPs section. If the issue persists, please contact us.
Content Type:
application/json
- Schema
- Example
- objectErrorResponseExample:
{"message":"string","errors":{}}
Properties:message
stringRequiredError messageExample:"string"
errors
object or nullInput validation errorsExample:{}
404
Not found. The action cannot be performed on a non-existing resource. Please check the proxy's ID.
Content Type:
application/json
- Schema
- Example
- objectErrorResponseExample:
{"message":"string","errors":{}}
Properties:message
stringRequiredError messageExample:"string"
errors
object or nullInput validation errorsExample:{}