API
Start typing to search…

Request content with cURL

post https://{hostname}/edge-diagnostics/v1/curl

Requests content using the curl command to provide the raw HTML for a URL, including request headers. You can run this operation for a specific location, an edge server IP, or a Site Shield map. If you want to get the data for a location, you need to run the List available edge server locations operation first to get edgeLocationId. And if you want to run this operation for an IP, you may need to verify an IP to check if it belongs to an edge server. If you provide neither a location nor an edge server IP, then Edge Diagnostics runs the operation using a random edge server IP.

Query Params
string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params
string
length ≥ 1

HTTP client IP from where the request initiated. You need to provide either this value or edgeLocationId.

string
length ≥ 1

Unique identifier for an edge server location closest to your end users. To get this value, run the List available edge server locations operation first. You need to provide either this value or edgeIp.

string
enum

IP version to use to run the operation, either IPV4 or IPV6.

Allowed:
requestHeaders
array of strings
length ≥ 0

Customized headers for curl request in the format header: value. Check Pragma headers for the list of Akamaized Pragma headers you can use here.

requestHeaders
boolean

Runs curl from a Site Shield map. To learn more, check Site Shield requests.

sensitiveRequestHeaderKeys
array of strings
length ≥ 0

Sensitive requestHeaders you don't want to store in the database after running the request. Check Sensitive headers to see the list of request headers treated as sensitive by default.

sensitiveRequestHeaderKeys
string
length ≥ 1

IP of the edge server you want to serve traffic from.

uri
required

URL you want to get the raw HTML for.

Responses

curl results and details about the request.

Response body
object
date-time
required

ISO 8601 timestamp indicating when the request was completed.

string
required
length ≥ 1

Username who submitted the request.

date-time
required

ISO 8601 timestamp indicating when the request was submitted.

edgeIpLocation
object
required

Specifies the geolocation of the edge server used to run the operation.

integer
required
≥ 0

Autonomous System Number the edge IP maps to.

string
required
length ≥ 1

Closest city within a 50-mile radius the edge IP maps to.

string
required
length ≥ 1

ISO 3166 country code the edge IP maps to.

string
length ≥ 1

ISO 3166 region code the edge IP maps to.

string
enum
required

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

SUCCESS FAILURE

string
required
length ≥ 1

If your request contained edgeLocationId then this is the IP of a machine in that location. If you run the operation for a VIP, then this is the IP of a machine behind that VIP.

request
object
required

Specifies your curl request.

string
length ≥ 1

HTTP client IP from where the request initiated. You need to provide either this value or edgeLocationId.

string
length ≥ 1

Unique identifier for an edge server location closest to your end users. To get this value, run the List available edge server locations operation first. You need to provide either this value or edgeIp.

string
enum

IP version to use to run the operation, either IPV4 or IPV6.

IPV4 IPV6

requestHeaders
array of strings
length ≥ 0

Customized headers for curl request in the format header: value. Check Pragma headers for the list of Akamaized Pragma headers you can use here.

requestHeaders
boolean

Runs curl from a Site Shield map. To learn more, check Site Shield requests.

sensitiveRequestHeaderKeys
array of strings
length ≥ 0

Sensitive requestHeaders you don't want to store in the database after running the request. Check Sensitive headers to see the list of request headers treated as sensitive by default.

sensitiveRequestHeaderKeys
string
length ≥ 1

IP of the edge server you want to serve traffic from.

uri
required

URL you want to get the raw HTML for.

result
object

Results of the curl command.

integer
≥ 0

Curl command exit code. To learn more, check the list of possible curl exit codes.

integer
100 to 599

Returned HTTP response code.

string
length ≥ 1

HTTP version used for curl.

string
length ≥ 1

Reason phrase for the response.

string
length ≥ 1

Entire response body.

responseHeaderList
array of strings
required
length ≥ 0

Collects the response headers in the format header: value.

responseHeaderList*
timing
object

Collects the time related data.

string
length ≥ 1

If your request specifies runFromSiteShield as true, then this is the IP used to run cURL.

siteShieldIpLocation
object

Specifies the geolocation of the edge server used to run the operation. It appears only for runFromSiteShield set to true.

integer
required
≥ 0

Autonomous System Number the edge IP maps to.

string
required
length ≥ 1

Closest city within a 50-mile radius the edge IP maps to.

string
required
length ≥ 1

ISO 3166 country code the edge IP maps to.

string
length ≥ 1

ISO 3166 region code the edge IP maps to.

suggestedActions
array of strings
length ≥ 0

Suggestions on what to do next with the results.

suggestedActions
Headers
object
integer

The rate limit ceiling for this endpoint.

integer

The number of requests left for the time window.

Updated almost 2 years ago

Did this page help you?
Language
Authentication
Remember to add your authentication credentials to run this code.
URL

Updated almost 2 years ago

Did this page help you?