Répertorier les domaines

GET

https://www.digicert.com/services/v2/domain

Appelez ce point de terminaison pour répertorier tous les domaines de votre compte.

cURL

curl -X GET \
  'https://www.digicert.com/services/v2/domain?include_validation=true' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Python

import requests

url = "https://www.digicert.com/services/v2/domain"

querystring = {"include_validation":"true"}

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/domain?include_validation=true"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

NodeJS

var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/domain',
  qs: { include_validation: 'true' },
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

200 OK

{
  "domains": [
    {
      "id": 2,
      "is_active": true,
      "name": "underlier-stanislavsky.org",
      "date_created": "2018-11-08T23:38:02+00:00",
      "organization": {
        "id": 516680,
        "status": "active",
        "name": "Example Company, Inc.",
        "display_name": "Example Company, Inc.",
        "is_active": "1"
      },
      "validations": [
         {
              "type": "ev",
              "name": "EV",
              "description": "Extended Organization Validation (EV)",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2021-04-11T06:00:00+00:00",
              "status": "active"
         },
         {
              "type": "ov",
              "name": "OV",
              "description": "Normal Organization Validation",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2022-06-14T06:00:00+00:00",
              "status": "active"
          }
      ],
      "dcv_method": "email",
      "dcv_expiration": {
          "ov": "2021-01-01T23:59:59+00:00"
          "ev": "2020-01-01T23:59:59+00:00"
       },   
      "container": {
        "id": 93288,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    },
    {
      "id": 1,
      "is_active": true,
      "name": "entitative-absurdly.org",
      "date_created": "2018-11-01T17:44:31+00:00",
      "organization": {
        "id": 516681,
        "status": "active",
        "name": "Lackadaisically Fumiest Inc.",
        "assumed_name": "Lackadaisically Fumiest",
        "display_name": "Lackadaisically Fumiest Inc. (Lackadaisically Fumiest)",
        "is_active": "1"
      },
      "validations": [
         {
              "type": "ev",
              "name": "EV",
              "description": "Extended Organization Validation (EV)",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2021-04-11T06:00:00+00:00",
              "status": "active"
         },
         {
              "type": "ov",
              "name": "OV",
              "description": "Normal Organization Validation",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2022-06-14T06:00:00+00:00",
              "status": "active"
          }
      ],
      "dcv_method": "email",
      "dcv_expiration": {
          "ov": "2021-01-01T23:59:59+00:00"
          "ev": "2020-01-01T23:59:59+00:00"
       },   
      "container": {
        "id": 93288,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    }
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}

Chaînes de requête d’URL

Nom	Obligatoire/facultatif	Type	Description
container_id	Facultatif	int	Liste des domaines affectés au conteneur spécifié
include_validation	Facultatif	bool	Inclut les informations de validation si `true`. Valeur par défaut : `false`
limit	Facultatif	int	Tronque la liste à partir du numéro de page spécifié. Max : `1000` (par défaut)
offset	Facultatif	int	Affiche la liste à partir du numéro de page spécifié. Valeur par défaut : `0`

Paramètres de réponse

Nom	Type	Description
domains	array	Liste des domaines renvoyés par la demande
.. id	int	ID du domaine
.. is_active	bool	Statut actif du domaine
.. status	string	Statut de validation du domaine
.. name	string	Nom du domaine
.. date_created	string	Horodatage de l’ajout du domaine Format : Fuseau horaire UTC et date ISO 8601
.. organization	object	Organisation rattachée au domaine
.. .. id	int	ID de l’organisation
.. .. status	string	Statut de validation de l’organisation
.. .. name	string	Nom légal de l’organisation
.. .. assumed_name	string	Nom public de l’organisation Également appelé « nom DBA »
.. .. display_name	string	Nom complet de l’organisation Composé du nom + assumed_name.
.. is_active	string	Statut actif de l’organisation
.. validations	array	Liste des détails de validation pour le domaine Renvoyé seulement si la requête d’URL est `include_validation=true`. Consultez la page Structures — Objet Validation.
.. dcv_method	string	Méthode de validation du contrôle de domaine configurée pour le domaine Consultez le Glossaire — Méthodes DCV
.. dcv_expiration	string	Si le DCV a été finalisé, cet objet est retourné avec des informations sur la date d'expiration des validations. Renvoyé seulement si la requête d’URL est `include_validation=true`.
.. .. ov	string	Horodatage d’expiration de la validation. Format : Fuseau horaire UTC et date ISO 8601
.. .. ev	string	Horodatage d’expiration de la validation. Format : Fuseau horaire UTC et date ISO 8601
.. dcv_token	object	Si la méthode DCV utilise un jeton de valeur aléatoire, cet objet est renvoyé et contient les informations du jeton.
.. .. token	string	Valeur aléatoire utilisée pour prouver le contrôle du domaine.
.. .. status	string	Statut du processus de validation du domaine
.. .. expiration_date	string	Horodatage de l’expiration du jeton Format : Fuseau horaire UTC et date ISO 8601
.. container	object	Conteneur auquel le domaine est rattaché
.. .. id	int	ID du conteneur
.. .. parent_id	int	ID du conteneur parent
.. .. name	string	Nom du conteneur
.. .. is_active	bool	Statut actif du conteneur
page	object	Détails sur les résultats Modifié en utilisant les chaînes de requête d’URL.

Chaînes de requête d’URL

Paramètres de réponse

À propos de