Difference between revisions of "DKIM (Rest API)"

From Rackspace Email & Apps API
Jump to: navigation, search
 
(5 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
== v1 - Current ==
 
== v1 - Current ==
 +
 +
=== Authentication and Authorization ===
 +
'''Authentication'''
 +
 +
Users of this API must be successfully authenticated.  See [http://api-wiki.apps.rackspace.com/api-wiki/index.php?title=Rest_API#Authentication 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 ===
 
=== Enable DKIM or Rotate Keys ===
  
 
''URL'':  
 
''URL'':  
−
  [POST] <nowiki>https://dkimadminapicp.mlsrvr.com/dkimstatus/enable</nowiki>
+
  [POST] <nowiki>https://api.emailsrvr.com/v2/customers/{customer_id}/domains/{domain_name}/dkim</nowiki>
  
  
 
''Description'':
 
''Description'':
  
−
Enables DKIM or rotates keys by generating a new certificate for message signing. Process needs to be completed using DKIM verification route.
+
Enables DKIM or rotates keys by generating a new certificate for message signing. Process needs to be completed using DKIM verification route (below).
  
  
Line 20: Line 30:
 
!''Description''
 
!''Description''
 
|-
 
|-
−
| domainName
+
| customer_id
 
| string
 
| string
−
| The domain on which to act
+
| ID of customer who owns domain_name
 
|-
 
|-
−
| hostedBy
+
| domain_name
 
| string
 
| string
−
| Can be set to '''external''' or '''internal'''
+
| Domain to act on
−
|-
 
−
| accountNumber
 
−
| string
 
−
| Account number the domain is under
 
−
|-
 
−
| adminEmail
 
−
| string
 
−
| Email address of the administrator configuring DKIM for the domain
 
−
|-
 
−
| firstName
 
−
| string
 
−
| First name of the administrator configuring DKIM for the domain
 
−
|-
 
−
| lastname
 
−
| string
 
−
| Last name of the administrator configuring DKIM for the domain
 
−
|-
 
−
| whiteLabel
 
−
| string
 
−
| Send white labeled email to administrator.  Can be '''true''' or '''false'''
 
 
|}
 
|}
  
Line 52: Line 42:
 
''Example'':
 
''Example'':
 
<pre>
 
<pre>
−
POST'/domains'
+
POST '/v2/customers/123123123/domains/not-a-real-domain.com/dkim'
 
</pre>
 
</pre>
  
Line 59: Line 49:
 
<pre>
 
<pre>
 
{
 
{
−
   "hostedBy": "external",
+
   "HostedBy": "external",
−
   "tatus": "pendingVerification",
+
   "Status": "pendingVerification",
 
   "subdomain": "20170209._domainkey",
 
   "subdomain": "20170209._domainkey",
 
   "dnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
 
   "dnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
 
}
 
}
 
</pre>
 
</pre>
 +
  
 
=== Get Domain's Current DKIM Status ===
 
=== Get Domain's Current DKIM Status ===
Line 70: Line 61:
 
''URL'':  
 
''URL'':  
  
−
  [GET] <nowiki>https://dkimadminapicp.mlsrvr.com/DkimServiceApi/v1/dkimstatus/status</nowiki>
+
  [GET] <nowiki>https://api.emailsrvr.com/v2/customers/{customer_id}/domains/{domain_name}/dkim</nowiki>
  
  
Line 84: Line 75:
 
!''Description''
 
!''Description''
 
|-
 
|-
−
| domain
+
| customer_id
 
| string
 
| string
−
| The domain on which to act
+
| ID of customer who owns domain_name
 
|-
 
|-
−
| hostedBy
+
| domain_name
 
| string
 
| string
−
| Can be set to '''external''' or '''internal'''
+
| Domain to act on
 
|}
 
|}
  
Line 96: Line 87:
 
''Examples'':
 
''Examples'':
 
<pre>
 
<pre>
−
GET '/domains/example.com?hostedBy=external'
+
GET '/v2/customers/123123123/domains/not-a-real-domain.com/dkim'
 
</pre>
 
</pre>
  
Line 111: Line 102:
 
}
 
}
 
</pre>
 
</pre>
 +
  
 
=== Disable DKIM on a Domain ===
 
=== Disable DKIM on a Domain ===
Line 116: Line 108:
 
''URL'':
 
''URL'':
  
−
  [DELETE] <nowiki>https://dkimadminapicp.mlsrvr.com/DkimServiceApi/v1/dkimstatus/disable)</nowiki>
+
  [DELETE] <nowiki>https://api.emailsrvr.com/v2/customers/{customer_id}/domains/{domain_name}/dkim</nowiki>
  
  
Line 130: Line 122:
 
!''Description''
 
!''Description''
 
|-
 
|-
−
| domain
+
| customer_id
 
| string
 
| string
−
| The domain on which to act
+
| ID of customer who owns domain_name
 
|-
 
|-
−
| hostedBy
+
| domain_name
 
| string
 
| string
−
| Can be set to '''external''' or '''internal'''
+
| Domain to act on
 
|}
 
|}
  
Line 142: Line 134:
 
''Example'':
 
''Example'':
 
<pre>
 
<pre>
−
DELETE '/dkimstatus/disable',
+
DELETE '/v2/customers/123123123/domains/not-a-real-domain.com/dkim',
 
</pre>
 
</pre>
 +
  
 
=== Complete and Verify Enabling DKIM or Rotating Domain Keys ===
 
=== Complete and Verify Enabling DKIM or Rotating Domain Keys ===
Line 149: Line 142:
 
''URL'':  
 
''URL'':  
  
−
  [POST] <nowiki>https://dkimadminapicp.mlsrvr.com/DkimServiceApi/v1/dkimstatus/verification</nowiki>
+
  [POST] <nowiki>https://api.emailsrvr.com/v2/customers/{customer_id}/domains/{domain_name}/dkim/verification</nowiki>
  
  
Line 164: Line 157:
 
!''Description''
 
!''Description''
 
|-
 
|-
−
| domain
+
| customer_id
 +
| string
 +
| ID of customer who owns domain_name
 +
|-
 +
| domain_name
 
| string
 
| string
−
| The domain on which to act
+
| Domain to act on
 
|}
 
|}
  
Line 172: Line 169:
 
''Example'':
 
''Example'':
 
<pre>
 
<pre>
−
POST '/dkimstatus/verification',
+
POST '/v2/customers/123123123/domains/not-a-real-domain.com/dkim/verification'
−
{
 
−
  "hostedBy": "external",
 
−
  "verificationSuccessful": false,
 
−
  "reason": "dnsKey mismatch",
 
−
  "subdomain": "20170209._domainkey",
 
−
  "dnsKey": "v=DKIM22; k=rsa; p=IAmABadKey",
 
−
  "expectedDnsKey": "v=DKIM1; k=rsa; p=DNSKEY"
 
−
}
 
 
</pre>
 
</pre>

Latest revision as of 12:11, 10 July 2019

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://api.emailsrvr.com/v2/customers/{customer_id}/domains/{domain_name}/dkim


Description:

Enables DKIM or rotates keys by generating a new certificate for message signing. Process needs to be completed using DKIM verification route (below).


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 '/v2/customers/123123123/domains/not-a-real-domain.com/dkim'


Status Code 200 Result Example: 

{
  "HostedBy": "external",
  "Status": "pendingVerification",
  "subdomain": "20170209._domainkey",
  "dnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
}


Get Domain's Current DKIM Status

URL: 

[GET] https://api.emailsrvr.com/v2/customers/{customer_id}/domains/{domain_name}/dkim


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 '/v2/customers/123123123/domains/not-a-real-domain.com/dkim'


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://api.emailsrvr.com/v2/customers/{customer_id}/domains/{domain_name}/dkim


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 '/v2/customers/123123123/domains/not-a-real-domain.com/dkim',


Complete and Verify Enabling DKIM or Rotating Domain Keys

URL: 

[POST] https://api.emailsrvr.com/v2/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 '/v2/customers/123123123/domains/not-a-real-domain.com/dkim/verification'
Retrieved from "http://api-wiki.apps.rackspace.com/api-wiki/index.php?title=DKIM_(Rest_API)&oldid=772"