Verify and locate an IP

post https://{hostname}/edge-diagnostics/v1/verify-locate-ip

Verifies if an IP belongs to an edge server and gets the geolocation data of its network. For IPs verified positively, you can continue gathering diagnostic data with Request content with cURL, Get domain details with dig, or Test network connectivity with MTR operations.

Responses

Response body

object

createdBy

string

required

length ≥ 1

Username who submitted the request.

createdTime

date-time

required

ISO 8601 timestamp indicating when the request was submitted.

executionStatus

string

required

Status of the request's execution, either SUCCESS or FAILURE.

SUCCESS FAILURE

request

object

required

IP address you want to get the data for.

ipAddress

string

required

length ≥ 1

IP address you want to get the data for.

result

object

required

Specifies the IP's network location and verification results.

geoLocation

object

required

Specifies the IP's network location. To learn more about the results, check Verify and Locate IP results.

isEdgeIp

boolean

required

Results of the verification.

Headers

object

X-RateLimit-Limit

integer

The rate limit ceiling for this endpoint.

X-RateLimit-Remaining

integer

The number of requests left for the time window.

Language

Authentication

Remember to add your authentication credentials to run this code.

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://hostname/edge-diagnostics/v1/verify-locate-ip \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
23
 
1
{
2
  "createdBy": "jsmith",
3
  "createdTime": "2021-10-04T15:01:46Z",
4
  "executionStatus": "SUCCESS",
5
  "request": {
6
    "ipAddress": "192.0.2.12"
7
  },
8
  "result": {
9
    "geoLocation": {
10
      "asNumber": 4808,
11
      "city": "BEIJING",
12
      "continent": "AS",
13
      "countryCode": "CN",
14
      "latitude": 39.9,
15
      "longitude": 116.41,
16
      "network": "chinaunicom",
17
      "regionCode": "BJ",
18
      "throughput": "vhigh",
19
      "timeZone": "GMT+8"
20
    },
21
    "isEdgeIp": false
22
  }
23
}

200The response provides the verification results, network location data, and details about the request.

400Validation error.

401Authorization error.

403Permission error.

405Method not allowed.

429Too many requests.