order_details

QUERY
https://www.digicert.com/services/v2/reports/query

Usa questa query per ottenere dettagli specifici per tutti gli ordini di certificato.

Per ricevere dettagli specifici per un singolo ordine di certificato, usa la query order_details_by_id.

GraphQL
{
    order_details(valid_till:"2020-10-26",limit:5,sort:["valid_from","DESC"]) {
        id
        common_name
        dns_names
        organization_id
        status
        valid_from
        valid_till
    }
}
200 OK
{
    "data": {
        "order_details": [
            {
                "id": "123456",
                "common_name": "digicert.com",
                "dns_names": null,
                "organization_id": "112233",
                "status": "issued",
                "valid_from": "2019-10-04",
                "valid_till": "2020-10-08"
            },
            {
                "id": "123458",
                "common_name": "dev.digicert.com",
                "dns_names": null,
                "organization_id": "223344",
                "status": "issued",
                "valid_from": "2019-10-03",
                "valid_till": "2020-10-07"
            },
            {
                "id": "123443",
                "common_name": "example.com",
                "dns_names": "sub.example.com,www.example.com",
                "organization_id": "112233",
                "status": "revoked",
                "valid_from": "2019-10-02",
                "valid_till": "2020-10-06"
            },
            {
                "id": "123460",
                "common_name": "example.net",
                "dns_names": "www.example.net",
                "organization_id": "112233",
                "status": "issued",
                "valid_from": "2019-09-30",
                "valid_till": "2020-10-07"
            },
            {
                "id": "123424",
                "common_name": "example.org",
                "dns_names": "test.example.org,monitor.example.org,api.example.org",
                "organization_id": "334455",
                "status": "issued",
                "valid_from": "2019-09-27",
                "valid_till": "2020-10-01"
            }
        ]
    }
}

Argomenti

Includi argomenti query per filtrare, cercare o manipolare i dati. Separa più argomenti con le virgole. Ad eccezione di ordina, tutti gli argomenti usano un formato chiave:valore (ad es. status:"issued").

Filtri

Usa gli argomenti filtro per restringere i dati di query ai valori di parametro specificati. Si possono usare più filtri per restringere ulteriormente i risultati.

Nome Rich/Opz Tipo Descrizione
id facoltativo int ID ordine.
status facoltativo string Stato ordine.
Consulta Glossario — Stato ordine
valid_from facoltativo string Data in cui inizia la validità del certificato.
Formato: yyyy-MM-dd
Operatore: >=
valid_till facoltativo string Data in cui termina la validità del certificato.
Formato: yyyy-MM-dd
Operatore: <=
container_id facoltativo string ID contenitore.
organization_id facoltativo string ID organizzazione.
product_name_id facoltativo string ID nome del prodotto.
Consulta Glossario — Identificatori di prodotto
serial_number facoltativo string Numero di serie del certificato.
signature_hash facoltativo string Hash firma usato per firmare la richiesta di certificato.
user_id facoltativo string ID dell’utente che ha effettuato l’ordine.
date_created facoltativo string Data in cui è stato effettuato l’ordine.
Formato: yyyy-MM-dd HH:mm:ss
Operatore: >=
ca_cert_id facoltativo string ID dell’autorità di certificazione emittente.
common_name facoltativo string Nome protetto dal certificato.
Usa % per un operatore like (ad es. common_name:"%example.com").
dns_names facoltativo string Elenco degli altri nomi protetti dal certificato.
locale facoltativo string Luogo dell’ordine.
Consulta Glossario — Codici luogo
thumbprint facoltativo string Identificazione personale del certificato.
email facoltativo string E-mail ordine cliente.

Cerca

Usa la ricerca argomento per trovare una stringa specifica contenuta nei campi cercati.

Nome Rich/Opz Tipo Descrizione
search facoltativo string Cerca campi specifici per la stringa inclusa.
Usa % per un operatore like (ad es. search:"%example.com").
Campi cercati: id, status, container_id, organization_id, product_name_id, additional_emails, organization_name, product_name, serial_number, user_id, common_name, email

Ordina ed esegui paginazione

Usa ordina ed esegui paginazione degli argomenti per manipolare i risultati della query restituiti.

Nome Rich/Opz Tipo Descrizione
ordine facoltativo matrice Specifica il campo ordine e la direzione.
Formato: ["{{field}}","{{direction}}"]
Valori consentiti (campo): valid_till, container_id, organization_id, product_name_id, serial_number, signature_hash, user_id, date_created, ca_cert_id, common_name, dns_names, locale, thumbprint, email
Valori consentiti (direzione): ASC, DESC
Predefinita: ["id","DESC"]
offset facoltativo int Avvia elenco nel numero specificato per la paginazione.
Predefinita: 0
limit facoltativo int Tronca elenco nel numero specificato per la paginazione.
Max: 1000 (impostazione predefinita)

Campi

Almeno un campo deve essere incluso nella richiesta. Se non viene inviato alcun campo, viene riportato un errore di sintassi.

Se non esistono dati per il campo, viene riportato un valore null.

Nome Tipo Descrizione
account_id string ID account associato all’ordine.
additional_emails string Altri indirizzi e-mail riportati sull’ordine.
agreement_id string ID CSA concordata.
auto_renew string Specifica se il certificato deve rinnovarsi automaticamente.
Valori possibili: 0 (disabilitata), 1 (abilitata)
ca_cert_id string ID dell’autorità di certificazione emittente.
certificate_tracker_id string ID certificato.
common_name string Nome protetto dal certificato.
contacts_email string Indirizzo e-mail del contatto organizzazione.
container_id string ID contenitore dell’ordine.
container_name string Nome contenitore dell’ordine.
cost string Costo ordine.
csr string Richiesta di firma certificato (CSR).
custom_renewal_message string Messaggio personalizzato incluso nelle notifiche di rinnovo.
customer_order_id string ID ordine cliente.
date_created string Data in cui è stato effettuato l’ordine.
Formato: yyyy-MM-dd HH:mm:ss
dcv_method string Metodo di convalida controllo dominio configurato per il dominio.
Consulta Glossario — Metodi DCV
disable_issuance_email string Specifica se vengono inviate le e-mail di emissione.
Valori possibili: 0 (falso), 1 (vero)
disable_renewal_notifications string Specifica se le notifiche di rinnovo sono abilitate.
Valori possibili: 0 (falso), 1 (vero)
dns_names string Elenco separato da virgola degli altri nomi protetti dal certificato.
email string Se il certificato ha un indirizzo e-mail nidificato (ad es. certificati client), riporta l’indirizzo e-mail sul certificato.
firstname string Nome del contatto dell'organizzazione.
has_duplicates int Specifica se il certificato ha dei duplicati.
Valori possibili: 0 (falso), 1 (vero)
id string ID ordine.
is_out_of_contract string Stato del contratto dell’ordine.
Valori possibili: 0 (falso), 1 (vero)
is_renewed string Specifica se l’ordine è stato rinnovato.
Valori possibili: 0 (falso), 1 (vero)
issuer_common_name string Nome descrittivo dell’autorità di certificazione emittente.
job_title string Qualifica del contatto dell’organizzazione.
lastname string Cognome del contatto dell'organizzazione.
locale string Luogo dell’ordine.
Consulta Glossario — Codici luogo
metadati stringa Dettagli campo personalizzato.
Formato: {{metadata_id}} {{metadata_label}} {{metadata_value}}Separatore dati: 0x1f
org_addr1 string Indirizzo organizzazione.
org_addr2 string
organization_city string Città in cui si trova l’organizzazione.
organization_country string Paese in cui si trova l’organizzazione.
organization_id string ID organizzazione associato all’ordine.
organization_name string Nome organizzazione.
organization_state string Stato in cui si trova l’organizzazione.
organization_unit string Unità organizzazione riportate sul certificato.
pay_type string Metodo di pagamento usato per l’ordine.
Valori possibili: A (saldo account), C (carta di credito)
plus_feature string Specifica se la funzione più è abilitata per l’ordine.
Valori possibili: 0 (disabilitata), 1 (abilitata)
product_id string ID del prodotto.
product_name string Nome di visualizzazione del prodotto.
Consulta Glossario — Identificatori di prodotto
product_name_id string ID nome del prodotto.
Consulta Glossario — Identificatori di prodotto
product_type string Tipo di prodotto.
Consulta Glossario — Tipi di Prodotto
purchased_dns_names string Numero di altri SAN acquistati.
receipt_id string ID ricevuta.
Renewed string Specifica se l’ordine è stato rinnovato.
Valori possibili: FALSE, TRUE
renewed_order_id string ID ordine dell’ordine precedente.
Riportato solo se l’ordine prevede un rinnovo.
serial_number string Numero di serie del certificato.
serversw string ID piattaforma server.
Consulta Glossario — Piatteforme server
signature_hash string Hash firma usato per firmare la richiesta di certificato.
status string Stato ordine.
Consulta Glossario — Stato ordine
telephone string Numero di telefono del contatto dell'organizzazione.
thumbprint string Identificazione personale del certificato.
user_assignments string ID dell’utente assegnato all’ordine.
user_email string Indirizzo e-mail dell’utente che ha richiesto il certificato.
user_first_name string Nome dell’utente che ha richiesto il certificato.
user_id string ID dell’utente che ha effettuato l’ordine.
user_last_name string Cognome dell’utente che ha richiesto il certificato.
valid_from string Data in cui inizia la validità del certificato.
Formato: yyyy-MM-dd
valid_till string Data in cui termina la validità del certificato.
Formato: yyyy-MM-dd
validity_years string Numero di anni in cui è valido il certificato.

Parametri di risposta

Nome Tipo Descrizione
data object Contenitore per i dati di query riportati.
.. order_details array Elenco degli oggetti ordine contenenti i campi di query.
.. .. {{campo}} - Campo e valore di query.
Campi riportati che dipendono dalla query inviata.