Répertorier les organisations

GET
https://www.digicert.com/services/v2/organization

Exécutez ce point de terminaison pour répertorier toutes les organisations de votre compte.

Remplacez l’en-tête ACCEPT par text/csv pour renvoyer les résultats dans un fichier CSV.

cURL
curl -X GET \
  https://www.digicert.com/services/v2/organization \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

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

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

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

print(response.text)
Go
package main

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

func main() {

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

	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/organization',
  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
{
  "organizations": [
    {
      "id": 1,
      "status": "active",
      "name": "DigiCert Inc.",
      "display_name": "DigiCert Inc.",
      "is_active": true,
      "address": "2801 N Thanksgiving Way",
      "address2": "Suite 500",
      "zip": "84043",
      "city": "Lehi",
      "state": "Utah",
      "country": "us",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    },
    {
      "id": 112233,
      "status": "active",
      "name": "Example Organization Inc.",
      "assumed_name": "Example Org",
      "display_name": "Example Organization",
      "is_active": true,
      "address": "123 Fake Stree",
      "address2": "Floor 55",
      "zip": "84043",
      "city": "Lehi",
      "state": "ut",
      "country": "us",
      "telephone": "801-701-9600",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      },
      "container_id_assignments": [
        "112234",
        "112235"
      ]
    }
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}
200 OK (include_validation=true)
{
  "organizations": [
    {
      "id": 1,
      "status": "active",
      "name": "DigiCert Inc.",
      "display_name": "DigiCert Inc.",
      "is_active": true,
      "address": "2801 N Thanksgiving Way",
      "address2": "Suite 500",
      "zip": "84043",
      "city": "Lehi",
      "state": "Utah",
      "country": "us",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    },
    {
      "id": 112233,
      "status": "active",
      "name": "Example Organization Inc.",
      "assumed_name": "Example Org",
      "display_name": "Example Organization",
      "is_active": true,
      "address": "123 Fake Stree",
      "address2": "Floor 55",
      "zip": "84043",
      "city": "Lehi",
      "state": "ut",
      "country": "us",
      "telephone": "801-701-9600",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      },
      "validations": [
        {
          "type": "ov",
          "name": "OV",
          "description": "Normal Organization Validation",
          "date_created": "2018-10-09T19:29:02+00:00",
          "validated_until": "2019-11-09T20:28:55+00:00",
          "status": "active"
        },
        {
          "type": "ev",
          "name": "EV",
          "description": "Extended Organization Validation (EV)",
          "status": "pending"
        },
      ],
      "ev_approvers": [
        {
          "id": 184,
          "first_name": "Destinee",
          "last_name": "Church"
        }
      ],
      "container_id_assignments": [
        "112234",
        "112235"
      ]
    }
  ]
}

Chaînes de requête d’URL

Nom Obligatoire/facultatif Type Description
container_id Facultatif int Filtre les résultats correspondant au conteneur spécifié.
include_validation Facultatif bool Spécifie si les détails de validation d’une organisation doivent être renvoyés.
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
organizations array Liste des organisations renvoyées par la demande.
.. id int ID de l’organisation
.. status string Statut de l’organisation
Valeurs possibles : active, inactive
.. 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 bool Statut actif de l’organisation
.. address string Adresse de l’organisation
.. address2 Chaîne
.. zip string Code postal de l’organisation
.. city string Ville où est établie l’organisation
.. state string État où est établie l’organisation
.. country string Pays de l’organisation
.. container object Conteneur primaire auquel l’organisation est rattachée
.. .. id int ID du conteneur
.. .. parent_id int ID du conteneur parent
.. .. name string Nom du conteneur
.. .. is_active bool Statut actif du conteneur
.. validations array Types de validation pouvant être utilisés par l’organisation
Renvoyé seulement si la requête d’URL est include_validation=true.
.. ev_approvers array Liste des utilisateurs autorisés à approuver les commandes de certificats EV et de signature de code
Renvoyé seulement si la requête d’URL est include_validation=true.
.. extended validation object Informations de validation supplémentaires sur l’organisation
Renvoyé seulement si la requête d’URL est include_validation=true.
.. container_id_assignments array Liste des conteneurs auxquels l’organisation est affectée.
page object Détails sur les résultats
Modifié en utilisant les chaînes de requête d’URL.