order_details

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

Utilisez cette requête pour obtenir des détails spécifiques pour toutes les commandes de certificats.

Pour obtenir des détails spécifiques pour une seule commande de certificat, utilisez order_details_by_id la requête.

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

Arguments

Inclure des arguments de requête pour filtrer, rechercher ou manipuler les données. Séparez les arguments multiples par des virgules. À l'exception du tri, tous les arguments utilisent un format clé:valeur (par exemple, status:"issued").

Filtres

Utilisez des arguments de filtre pour limiter les données de la requête à des valeurs de paramètres spécifiées. Plusieurs filtres peuvent être utilisés pour restreindre davantage les résultats.

Nom Obligatoire/facultatif Type Description
id Facultatif int ID de la commande
status Facultatif string Statut de la commande
Consultez le Glossaire — Statut de la commande
valid_from Facultatif string Date de début de validité du certificat
Format : yyyy-MM-dd
Opérateur : >=
valid_till Facultatif string Date de fin de validité du certificat
Format : yyyy-MM-dd
Opérateur : <=
container_id Facultatif string ID du conteneur
organization_id Facultatif string ID de l’organisation
product_name_id Facultatif string ID du nom du produit
Consultez le Glossaire — Identificateurs de produits
serial_number Facultatif string Numéro de série du certificat
signature_hash Facultatif string Hachage de signature utilisé pour signer la demande de certificat
user_id Facultatif string ID de l’utilisateur qui a passé la commande
date_created Facultatif string Date de passation de la commande
Format : yyyy-MM-dd HH:mm:ss
Opérateur : >=
ca_cert_id Facultatif string ID de l'autorité de certification émettrice
common_name Facultatif string Nom protégé par le certificat
Utilisez % pour un opérateur similaire (p. ex., common_name:"%example.com").
dns_names Facultatif string Liste des noms supplémentaires protégés par le certificat
locale Facultatif string Localisation de la commande.
Consultez le Glossaire — Codes de paramètres régionaux.
thumbprint Facultatif string Empreinte du certificat
email Facultatif string Courrier électronique de la commande personnalisé.

Recherche

Utilisez l'argument de recherche pour trouver une chaîne spécifique contenue dans les champs recherchés.

Nom Obligatoire/facultatif Type Description
search Facultatif string Recherchez des champs spécifiques pour la chaîne incluse.
Utilisez % pour un opérateur similaire (p. ex., search:"%example.com").
Champs de recherche : id, status, container_id, organization_id, product_name_id, additional_emails, organization_name, product_name, serial_number, user_id, common_name, email

Tri et pagination

Utilisez des arguments de tri et de pagination pour manipuler les résultats de la requête renvoyée.

Nom Obligatoire/facultatif Type Description
trie Facultatif groupe Indiquez le champ de tri et la direction.
Format : ["{{field}}","{{direction}}"]
Valeurs autorisées (champ) : 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
Valeurs autorisées (direction) : ASC, DESC
Valeur par défaut : ["id","DESC"]
offset Facultatif int Affiche la liste à partir du numéro de page spécifié.
Valeur par défaut : 0
limit Facultatif int Tronque la liste à partir du numéro de page spécifié.
Max : 1000 (par défaut)

Champs

Au moins un champ doit être inclus dans la demande. Si aucun champ n'est envoyé, une erreur de syntaxe est renvoyée.

S’il n’existe pas de données pour le champ, une valeur de null est renvoyée.

Nom Type Description
account_id string ID de compte associé à la commande
additional_emails string Adresses électroniques supplémentaires associées à la commande
agreement_id string ID du CSA accepté
auto_renew string Spécifier si le certificat doit automatiquement être renouvelé.
Valeurs possibles : 0 (désactivé), 1 (activé)
ca_cert_id string ID de l'autorité de certification émettrice
certificate_tracker_id string ID du certificat
common_name string Nom protégé par le certificat
contacts_email string Adresse électronique du contact de l'organisation
container_id string ID du conteneur de la commande
container_name string Nom du conteneur de la commande
cost string Coût de la commande
csr string Demande de signature de certificat (Certificate Signing Request, CSR)
custom_renewal_message string Message personnalisé inclus dans les notifications de renouvellement
customer_order_id string ID de la commande personnalisé
date_created string Date de passation de la commande
Format : yyyy-MM-dd HH:mm:ss
dcv_method string Méthode de validation du contrôle de domaine configurée pour le domaine
Consultez le Glossaire — Méthodes DCV
disable_issuance_email string Indique si les courriers électroniques sont envoyés.
Valeurs possibles : 0 (faux), 1 (vrai)
disable_renewal_notifications string Indique si les notifications de renouvellement sont activées.
Valeurs possibles : 0 (faux), 1 (vrai)
dns_names string Liste séparée par une virgule des noms supplémentaires protégés par le certificat.
email string Si le certificat comporte une adresse électronique intégrée (par exemple, des certificats de client), renvoie l'adresse électronique figurant sur le certificat.
firstname string Prénom du contact de l’organisation.
has_duplicates int Indique si le certificat comprend des duplicatas.
Valeurs possibles : 0 (faux), 1 (vrai)
id string ID de la commande
is_out_of_contract string Statut du contrat de la commande
Valeurs possibles : 0 (faux), 1 (vrai)
is_renewed string Indique si la commande a été renouvelée.
Valeurs possibles : 0 (faux), 1 (vrai)
issuer_common_name string Nom personnalisé de l'autorité de certification émettrice.
job_title string Intitulé de poste du contact de l'organisation.
lastname string Nom du contact de l’organisation
locale string Localisation de la commande.
Consultez le Glossaire — Codes de paramètres régionaux.
metadata Chaîne Détails de champ personnalisé
Format : {{metadata_id}} {{metadata_label}} {{metadata_value}}Séparateur de données : 0x1f
org_addr1 string Adresse de l’organisation
org_addr2 string
organization_city string Ville où est établie l’organisation
organization_country string Pays où est établie l’organisation
organization_id string ID de l’organisation associée à la commande
organization_name string Nom de l’organisation
organization_state string État où est établie l’organisation
organization_unit string Unités organisationnelles associées au certificat
pay_type string Mode de paiement utilisé pour la commande
Valeurs possibles : A (solde du compte), C (carte bancaire)
plus_feature string Indique si la fonction Plus est activée pour la commande.
Valeurs possibles : 0 (désactivé), 1 (activé)
product_id string ID du produit
product_name string Nom d’affichage du produit
Consultez le Glossaire — Identificateurs de produits
product_name_id string ID du nom du produit
Consultez le Glossaire — Identificateurs de produits
product_type string Type du produit
Consultez le Glossaire — Types de produits
purchased_dns_names string Nombre de noms SAN supplémentaires achetés
receipt_id string ID du reçu
Renewed string Indique si la commande a été renouvelée.
Valeurs possibles : FALSE, TRUE
renewed_order_id string ID de la commande précédente
Renvoyé seulement si la commande est un renouvellement.
serial_number string Numéro de série du certificat
serversw string Identificateur de la plate-forme serveur
Consultez le Glossaire — Plateformes serveurs.
signature_hash string Hachage de signature utilisé pour signer la demande de certificat
status string Statut de la commande
Consultez le Glossaire — Statut de la commande
telephone string Numéro de téléphone du contact de l’organisation.
thumbprint string Empreinte du certificat
user_assignments string ID de l’utilisateur associé à la commande
user_email string Adresse électronique de l’utilisateur ayant demandé le certificat
user_first_name string Prénom de l’utilisateur ayant demandé le certificat
user_id string ID de l’utilisateur qui a passé la commande
user_last_name string Nom de l’utilisateur ayant demandé le certificat
valid_from string Date de début de validité du certificat
Format : yyyy-MM-dd
valid_till string Date de fin de validité du certificat
Format : yyyy-MM-dd
validity_years string Nombre d’années pendant lesquelles le certificat est valide

Paramètres de réponse

Nom Type Description
data object Conteneur pour les données de la requête renvoyées.
.. order_details array Liste des objets de commande contenant des champs de requête.
.. .. {{champ}} - Champ et valeur de requête.
Les champs renvoyés dépendent de la requête envoyée.