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)

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.

Stringhe di query URL

Parametri di risposta

Informazioni