Generate domain validation challenges
POST https://{{host}}/papi/v1/hostnames/certificate-challenges
If you're using Default Domain Validation (DV) certificates, you can generate the domain validation challenges ahead of setting hostnames for your property. Ordinarily, you get the challenges when you add hostnames to a property version or add hostnames to a property's hostname bucket. This operation returns the Note: If you're using a new account, first register it on the Akamai network by activating any property version on either staging or production. Otherwise, your attempts to generate certificates will fail with a 403 error.validationCname
object that you use to validate the certificate's domain. For each requested property hostname, create a new CNAME record in the DNS configuration and map the object's hostname
to the target
.
Body
PARAM
Key | Datatype | Required | Description |
accountSwitchKey
|
string | (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys). |
HEADERS
Key | Datatype | Required | Description |
Content-Type
|
string | ||
Accept
|
string |
RESPONSES
status OK
{
"accountId": "act_A-CCT9012",
"hostnames": {
"items": [
{
"cnameFrom": "www.example1.com",
"validationCname": {
"hostname": "_acme-challenge.www.example1.com",
"target": "ac.afae21b9a98d2d845d8032da0d689252.www.example1.com.validate-akdv.net"
}
},
{
"cnameFrom": "www.example2.com",
"validationCname": {
"hostname": "_acme-challenge.www.example2.com.com",
"target": "ac.afae21b9a98d2d845d8032da0d689252.www.example2.com.validate-akdv.net"
}
}
]
}
} |
ENDPOINTS