API guide
Overview
This guide provides step-by-step instructions for testing DigiCert® DNS's API endpoints using an API key generated within the DigiCert® DNS platform. Follow the procedure in order, or start at Step 2 if you already have an API key.
The full procedure includes:
Generating an API key: Generate an API key within DigiCert® DNS to authenticate requests to the API.
Accessing the DigiCert DNS API: Locate and review available API endpoints and their specifications.
Generating an authentication token: Use your API key to generate a bearer token for authorized access.
Testing an endpoint: Make a request to your chosen endpoint using the authentication token.
Downloads
API Version | Format | File Type | Notes |
|---|---|---|---|
1.0.0 | JSON | Ideal for quick imports into Postman or other testing tools | |
Ideal for use in automated pipelines | |||
YAML | Ideal for manually reviewing the API definition file | ||
Ideal for editing and maintaining the definition file in a modular format |
Procedure
Aviso
This procedure generates two API keys: apikey1 and apikey2. These API keys are referenced in other procedures. Follow Path 1 if you are an administrator, or Path 2 if you are a standard user.
To test this function, call this API endpoint: POST /accessmanagement/api-key
Path 1
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the USERS tab.
Select the user whose keys you want to manage.
Select the Generate API Key button.
In the Generate API Key dialog:
Enter a name for the key in the Name field (for example, apikey1).
Select an expiration option.
The default expiration date is set to one year from the current date.
(Optional) Add a note.
This can be viewed later by clicking the note icon next to the key.
Select Save to generate the API key.
In the API Key Generated - Action Required dialog:
Select Copy to copy the generated key.
Select Done to complete the process.
A message appears confirming the successful generation of the API key.
Repeat Steps 4-7 to create another API key, apikey2.
Path 2
Sign in to your DigiCert® DNS account.
From the landing page, click the user icon in the top right corner and select My API Keys.
Select the Generate API Key button.
A maximum of two API keys can exist at any given time.
In the Generate API Key dialog:
Enter a name for the key in the Name field (for example, apikey1).
Select an expiration option.
The default expiration date is set to one year from the current date.
(Optional) Add a note.
This can be viewed later by clicking the note icon next to the key.
Select Save to generate the API key.
In the API Key Generated - Action Required dialog:
Select Copy to copy the generated key.
Select Done to complete the process.
A message appears confirming the successful generation of the API key.
Repeat Steps 3-5 to create another API key, apikey2.
Aviso
This procedure explains how to access the DigiCert® DNS API by importing the definition file into a testing tool. While this guide uses Postman, other API testing tools can also be used.
Navigate to the Downloads section above.
Download the file you wish to import into Postman.
Log in to Postman.
In Postman:
If this is a new instance, go to Get Started > Import APIs and collections, then select Import.
Alternatively, click the Import button in the My Workspace sidebar.
Locate the file downloaded in Step 2.
In the Choose how to import your Specification dialog:
Confirm your file selection.
Select an import setting:
Postman Collection: Ideal for quickly testing and running pre-built API requests.
OpenAPI 3.0 Specification with a Postman Collection: Ideal for importing a full API definition with schema, for documentation and lifecycle management.
DigiCert® recommends selecting this option.
Select Import.
Confirm that DigiCert DNS appears in your workspace.
Generate an authentication token
Aviso
This procedure uses the API key generated in an earlier procedure to request an authentication token in Postman. The token is valid for one hour and must be refreshed before it expires. If the token is not regenerated in time, API endpoints cannot be tested. If the user no longer has access to their API key when the token expires, a new API key must be generated to obtain a new token.
To test this function, call this API endpoint: POST /auth/login
Log in to Postman.
In the My Workspace sidebar, navigate to DigiCert DNS > auth > login > POST /auth/login:
Go to the Authorization tab, and in the Token field, paste your API key.
Click Send.
In the response window, copy the authentication token.
In the My Workspace sidebar, select DigiCert DNS:
Go to the Auth tab, and paste your authentication token into the Token field.
Under the Add variable to heading, select Collection.
Aviso
This procedure explains how to use an authentication token to test endpoints in DigiCert® DNS. While this example tests an endpoint that returns the user's activity log, the same approach can be used to test any endpoint.
Log in to Postman.
In the My Workspace sidebar, navigate to DigiCert DNS.
Select an endpoint you want to test, for example,
GET /activitylog.Select Send.
The response window will populate with the API response.