Elenca organizzazioni

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

Usa questo endpoint per elencare tutte le organizzazioni nel tuo account.

Cambia l’intestazione ACCEPT con text/csv per avere un output CSV dei risultati.

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

Stringhe di query URL

Nome Rich/Opz Tipo Descrizione
container_id facoltativo int Filtra risultati nel contenitore specifico.
include_validation facoltativo bool Specifica se i dettagli di convalida per l’organizzazione devono essere riportati.
Predefinita: false
limit facoltativo int Tronca elenco nel numero specificato per la paginazione.
Max: 1000 (impostazione predefinita)
offset facoltativo int Avvia elenco nel numero specificato per la paginazione.
Predefinita: 0

Parametri di risposta

Nome Tipo Descrizione
organizations array Elenco delle organizzazioni riportate dalla richiesta.
.. id int ID organizzazione.
.. status string Stato organizzazione.
Valori possibili: active, inactive
.. name string Ragione sociale dell’organizzazione.
.. assumed_name string Nome pubblico dell’organizzazione.
Chiamato anche nome DBA.
.. display_name string Nome completo dell’organizzazione.
Costruito usando nome + assumed_name.
.. is_active bool Stato attivo dell’organizzazione.
.. address string Indirizzo dell’organizzazione.
.. address2 stringa
.. zip string Codice postale dell’organizzazione.
.. city string Città in cui si trova l’organizzazione.
.. state string Stato in cui si trova l’organizzazione.
.. country string Paese dell’organizzazione.
.. container object Contenitore principale a cui è collegata l’organizzazione.
.. .. id int ID contenitore.
.. .. parent_id int ID dell’elemento principale del contenitore.
.. .. name string Nome del contenitore.
.. .. is_active bool Stato attivo del contenitore.
.. validations array Tipi di convalida che l’organizzazione può usare.
Riportati solo in caso di query URL include_validation=true.
.. ev_approvers array Elenco degli utenti che possono approvare gli ordini di firma codice ed EV.
Riportati solo in caso di query URL include_validation=true.
.. extended validation object Informazioni sulla convalida estesa sull’organizzazione.
Riportati solo in caso di query URL include_validation=true.
.. container_id_assignments array Elenco dei contenitori a cui è assegnata l’organizzazione.
pagina object Dettagli sui risultati.
Modificati con le stringhe di query URL.