Listar domínios

GET

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

Use este ponto de extremidade para listar todos os domínios na sua conta.

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
  }
}

Cadeias de consulta de URL

Nome	Obr/Opc	Tipo	Descrição
container_id	opcional	int	Liste domínios atribuídos ao recipiente especificado.
include_validation	opcional	bool	Inclui informações de validação se `true`. Padrão: `false`
limit	opcional	int	Trunque a lista ao número especificado para paginação. Máx: `1000` (padrão)
offset	opcional	int	Comece a lista no número especificado para paginação. Padrão: `0`

Parâmetros da resposta

Nome	Tipo	Descrição
domains	array	Lista de domínios retornados pela solicitação.
.. id	int	ID do domínio.
.. is_active	bool	Status ativo do domínio.
.. status	string	Status de validação do domínio.
.. name	string	Nome do domínio.
.. date_created	string	Carimbo de data/hora de quando o domínio foi adicionado. Formato: Fuso horário UTC e data ISO 8601
.. organization	object	Organização anexada ao domínio.
.. .. id	int	ID da organização.
.. .. status	string	Status de validação da organização.
.. .. name	string	Nome jurídico da organização.
.. .. assumed_name	string	Nome público da organização. Também chamado de nome DBA.
.. .. display_name	string	Nome completo da organização. Construído usando nome + assumed_name.
.. is_active	string	Status ativo da organização.
.. validations	array	Lista de detalhes de validação para o domínio. Retornados apenas se a consulta URL `include_validation=true`. Consulte Estruturas — Objeto de validações.
.. dcv_method	string	Método de validação de controle do domínio configurado para o domínio. Consulte Glossário — Métodos DCV
.. dcv_expiration	string	Se o DCV estiver concluído, este objeto é retornado e possui informações sobre quando as validações expiram. Retornados apenas se a consulta URL `include_validation=true`.
.. .. ov	string	Carimbo de data/hora de quando a validação expira. Formato: Fuso horário UTC e data ISO 8601
.. .. ev	string	Carimbo de data/hora de quando a validação expira. Formato: Fuso horário UTC e data ISO 8601
.. dcv_token	object	Se o método DCV usar um token com valor aleatório, este objeto será retornado e possuirá informações do token.
.. .. token	string	Valor aleatório usado para provar controle sobre o domínio.
.. .. status	string	Status do processo de validação do domínio.
.. .. expiration_date	string	Carimbo de data/hora de quando o token expirará. Formato: Fuso horário UTC e data ISO 8601
.. container	object	Recipiente ao qual o domínio está anexado.
.. .. id	int	ID do recipiente.
.. .. parent_id	int	ID do pai do recipiente.
.. .. name	string	Nome do recipiente.
.. .. is_active	bool	Status ativo do recipiente.
página	object	Detalhes sobre resultados. Modificado usando cadeias de consulta URL.

Cadeias de consulta de URL

Parâmetros da resposta

Sobre