Difference between revisions of "DKIM (Rest API)"
| Line 55: | Line 55: | ||
} | } | ||
</pre> | </pre> | ||
| + | |||
=== Get Domain's Current DKIM Status === | === Get Domain's Current DKIM Status === | ||
| Line 101: | Line 102: | ||
} | } | ||
</pre> | </pre> | ||
| + | |||
=== Disable DKIM on a Domain === | === Disable DKIM on a Domain === | ||
| Line 134: | Line 136: | ||
DELETE '/customers/customer_id/domains/domain_name/dkim/disable', | DELETE '/customers/customer_id/domains/domain_name/dkim/disable', | ||
</pre> | </pre> | ||
| + | |||
=== Complete and Verify Enabling DKIM or Rotating Domain Keys === | === Complete and Verify Enabling DKIM or Rotating Domain Keys === | ||
| Line 166: | Line 169: | ||
''Example'': | ''Example'': | ||
<pre> | <pre> | ||
| − | POST '/customers/customer_id/domains/domain_name/dkim/verification' | + | POST '/customers/customer_id/domains/domain_name/dkim/verification' |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
</pre> | </pre> | ||
Revision as of 07:25, 7 February 2019
Contents
v1 - Current
Authentication and Authorization
Authentication
Users of this API must be successfully authenticated. See Rest API - Authentication for instructions.
Authorization
Authenticated users must have access to both the customer ID and the domain name that they provide.
Enable DKIM or Rotate Keys
URL:
[POST] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/enable
Description:
Enables DKIM or rotates keys by generating a new certificate for message signing. Process needs to be completed using DKIM verification route.
Parameters:
| Field Name | Data Type | Description |
|---|---|---|
| customer_id | string | ID of customer who owns domain_name |
| domain_name | string | Domain to act on |
Example:
POST '/customers/customer_id/domains/domain_name/dkim/enable'
Status Code 200 Result Example:
{
"hostedBy": "external",
"tatus": "pendingVerification",
"subdomain": "20170209._domainkey",
"dnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
}
Get Domain's Current DKIM Status
URL:
[GET] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/status
Description:
Returns the status of DKIM configuration for a domain.
Parameters:
| Field Name | Data Type | Description |
|---|---|---|
| customer_id | string | ID of customer who owns domain_name |
| domain_name | string | Domain to act on |
Examples:
GET '/customers/customer_id/domains/domain_name/dkim/status'
Status Code 200 Result Example:
{
"hostedBy": "external",
"status": "pendingVerification",
"selector": "20170209",
"subdomain": "20170209._domainkey",
"publicKey": "-----BEGIN PUBLIC KEY-----PublicKeyGoesHere-----END PUBLIC KEY-----",
"dnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
}
Disable DKIM on a Domain
URL:
[DELETE] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/disable
Description:
Disables DKIM for a domain by revoking all existing certificates.
Parameters:
| Field Name | Data Type | Description |
|---|---|---|
| customer_id | string | ID of customer who owns domain_name |
| domain_name | string | Domain to act on |
Example:
DELETE '/customers/customer_id/domains/domain_name/dkim/disable',
Complete and Verify Enabling DKIM or Rotating Domain Keys
URL:
[POST] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/verification
Description:
Verifies that a DNS record has been created with the selector/public key for DKIM as been added for a domain. If the record has been successfully verified, the certificate is enabled, and any other existing certificates are deleted.
Parameters:
| Field Name | Data Type | Description |
|---|---|---|
| customer_id | string | ID of customer who owns domain_name |
| domain_name | string | Domain to act on |
Example:
POST '/customers/customer_id/domains/domain_name/dkim/verification'
