Skip to content
Home » DICloak API – Proxy Interface

DICloak API – Proxy Interface

1.. Proxy Interface

GET to Obtain the Proxy List

GET /v1/proxys

Request Parameters

NameLocationTypeRequiredDescription
page_noqueryintegerNoPage number. The default value is 1.
page_sizequeryintegerNoPagination size. The default value is 10.
allquerybooleanNoWhether to obtain the full amount of data. When it is set to true, page_no and page_size will be ignored.
detailquerybooleanNoWhether details are required.
serial_numqueryintegerNoSerial number.
idquerystringNoID.
typequerystringNoProxy type (NON_USE: Not in use, HTTP, HTTPS, SSH, SOCKS5, IPFLY).
hostquerystringNoProxy host.
envquerystringNoUsing browser profile.
remarkquerystringNoRemarks.

Response Parameters

NameTypeDescription
listOpenApiProxyVO
totalinteger
OpenApiProxyVO
NameTypeDescription
idstringID.
create_timestringCreation time.
update_timestringUpdate time.
serial_numintegerSerial number.
typestringProxy type (NON_USE: Not in use, HTTP, HTTPS, SSH, SOCKS5, IPFLY).
hoststringProxy host.
portintegerProxy port.
user_namestringProxy account.
passwdstringProxy password.
ip_typestringIP query channel (IP2LOCATION).
statusstringStatus (WAIT to be detected, SUCCESS for success, FAIL for failure).
remarkstringRemarks.
proxy_ip_infoCheckProxyIpResultVOProxy information.
CheckProxyIpResultVO
NameTypeDescription
ipstringIP address.
connectbooleanWhether it can be connected or not.
countrystringCountry.
country_codestringCountry code.
regionstringRegion (province).
citystringCity.
timezonestringTime zone.
latitudestringLatitude.
longitudestringLongitude.
zip_codestringZip code.
err_msgstringError message.
check_timestringMonitoring time.
ip_typestringIP channel type.
{
  "code": 0,
  "msg": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "create_time": "string",
        "update_time": "string",
        "serial_num": 0,
        "type": "NON_USE",
        "host": "string",
        "port": 0,
        "user_name": "string",
        "passwd": "string",
        "ip_type": "IP2LOCATION",
        "status": "WAIT",
        "remark": "string",
        "proxy_ip_info": {
          "ip": "string",
          "connect": true,
          "country": "string",
          "country_code": "string",
          "region": "string",
          "city": "string",
          "timezone": "string",
          "latitude": "string",
          "longitude": "string",
          "zip_code": "string",
          "err_msg": "string",
          "check_time": "2019-08-24T14:15:22Z",
          "ip_type": "["
        }
      }
    ],
    "total": 0,
    "page_token": "string"
  }
}

GET to Obtain the Proxy Details

GET /v1/proxy/{id}

Request Parameters

NameLocationTypeRequiredDescription
idpathstringYes
X-API-KEYheaderstringYes

Return Results

Status CodeMeaning of Status CodeDescriptionData Model
200OKThe request was successful.Refer to the list fields.
{
  "code": 0,
  "msg": "string",
  "data": {
    "id": "string",
    "create_time": "string",
    "update_time": "string",
    "serial_num": 0,
    "type": "NON_USE",
    "host": "string",
    "port": 0,
    "user_name": "string",
    "passwd": "string",
    "ip_type": "IP2LOCATION",
    "status": "WAIT",
    "remark": "string",
    "proxy_ip_info": {
      "ip": "string",
      "connect": true,
      "country": "string",
      "country_code": "string",
      "region": "string",
      "city": "string",
      "timezone": "string",
      "latitude": "string",
      "longitude": "string",
      "zip_code": "string",
      "err_msg": "string",
      "check_time": "2019-08-24T14:15:22Z",
      "ip_type": "IP2LOCATION"
    }
  },
  "next": "string"
}

PUT to Modify the Proxy

PUT /v1/proxy/{id}

Request Parameters

NameLocationTypeRequiredDescription
idpathstringYes
X-API-KEYheaderstringYes
bodybodyOpenProxyEditReqNo
{
  "type": "NON_USE",
  "host": "string",
  "port": 0,
  "user_name": "string",
  "passwd": "string",
  "ip_type": "IP2LOCATION",
  "status": "WAIT",
  "remark": "string",
  "out_ip": "string"
}
OpenProxyEditReq
NameLocationTypeRequiredDescription
typebodystringNoProxy type (NON_USE: Not in use, HTTP, HTTPS, SSH, SOCKS5, IPFLY).
hostbodystringNoProxy host.
portbodyintegerNoProxy port.
user_namebodystringNoProxy account.
passwdbodystringNoProxy password.
ip_typebodystringNoIP query channel (IP2LOCATION).
statusbodystringNoStatus (WAIT to be detected, SUCCESS for success, FAIL for failure).
remarkbodystringNoRemarks.
out_ipbodystringNoOutbound IP.

Return Results

{
  "code": 0,
  "msg": "string",
  "data": {}
}

DELETE : Delete the Proxy

DELETE /v1/proxy/{id}

Request Parameters

NameLocationTypeRequiredDescription
idpathstringYesProxy ID, which is the ID returned in the list.
X-API-KEYheaderstringYes

Return Results

{
  "code": 0,
  "msg": "string",
  "data": {}
}