order_details

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

Verwenden Sie diese Abfrage, um spezifische Details über alle Zertifikatsaufträge zu erhalten.

Um spezifische Details über einen einzelnen Auftrag zu erfahren, verwenden Sie eine order_details_by_id-Abfrage.

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

Argumente

Fügen Sie Abfrageargumente hinzu, um die Daten zu filtern, zu durchsuchen oder zu manipulieren. Trennen Sie mehrere Argumente durch Kommas. Mit Ausnahme von sort, verwenden alle Argumente ein Key:Value-Format (z. B. status:"issued")

Filter

Verwenden Sie Filterargumente, um Abfragedaten auf angegebene Parameterwerte einzuengen. Es können mehrere Filter verwendet werden, um die Ergebnisse weiter einzuengen.

Name Antr./Opt. Typ Beschreibung
id optional int Auftrags-ID
status optional string Auftragsstatus
Siehe Glossar – Auftragsstatus
valid_from optional string Datum des Beginns der Laufzeit des Zertifikats
Format: yyyy-MM-dd
Operator: >=
valid_till optional string Datum des Laufzeitendes des Zertifikats
Format: yyyy-MM-dd
Operator: <=
container_id optional string Container-ID
organization_id optional string Organisations-ID
product_name_id optional string Name der Produkt-ID
Siehe Glossar – Produkt-IDs
serial_number optional string Seriennummer des Zertifikats
signature_hash optional string Zum Signieren des Zertifikats verwendeter Signatur-Hashwert
user_id optional string ID des Benutzers, der den Auftrag erteilt hat
date_created optional string Datum des Auftrags
Format: yyyy-MM-dd HH:mm:ss
Operator: >=
ca_cert_id optional string ID der ausstellenden Zertifizierungsstelle.
common_name optional string Durch das Zertifikat geschützter Name
Verwenden Sie % für einen LIKE-Operator (z. B. common_name:"%example.com").
dns_names optional string Liste der durch das Zertifikat geschützten zusätzlichen Namen
locale optional string Gebietsschema des Auftrags.
Siehe Glossar – Gebietsschemacodes
thumbprint optional string Fingerabdruck des Zertifikats
email optional string Kundenauftrags-E-Mail.

Suchen

Verwenden Sie das „Suchen“-Argument, um eine bestimmte Zeichenfolge zu finden, die in den Suchfeldern enthalten ist.

Name Antr./Opt. Typ Beschreibung
search optional string Durchsuchen Sie bestimmte Felder nach enthaltenen Zeichenfolgen.
Verwenden Sie % für einen LIKE-Operator (z. B. search:"%example.com").
Durchsuchte Felder: id, status, container_id, organization_id, product_name_id, additional_emails, organization_name, product_name, serial_number, user_id, common_name, email

Sortieren und Paginierung

Verwenden Sie die Argumente Sortieren und Paginierung, um die zurückgegebenen Abfrageergebnisse zu manipulieren.

Name Antr./Opt. Typ Beschreibung
Sortieren optional Array Sortierfeld and Richtung angeben.
Format: ["{{field}}","{{direction}}"]
Zulässige Werte (Feld): 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
Zulässige Werte (Richtung): ASC, DESC
Standard: ["id","DESC"]
offset optional int Liste bei der angegebenen Seitenzahl beginnen
Standard: 0
limit optional int Liste an der angegebenen Seitenzahl abschneiden
Max.: 1000 (Standard)

Felder

Mindestens ein Feld muss im Antrag enthalten sein. Sind keine Felder enthalten, wird ein Syntaxfehler zurückgegeben.

Falls für das Feld keine Daten vorhanden sind, wird null zurückgegeben.

Name Typ Beschreibung
account_id string Mit dem Auftrag verknüpfte Konto-ID
additional_emails string Zusätzliche E-Mail-Adressen auf dem Auftrag
agreement_id string ID des vereinbarten CSA
auto_renew string Soll das Zertifikat automatisch erneuert werden?
Mögliche Werte: 0 (deaktiviert), 1 (aktiviert)
ca_cert_id string ID der ausstellenden Zertifizierungsstelle.
certificate_tracker_id string Zertifikats-ID
common_name string Durch das Zertifikat geschützter Name
contacts_email string E-Mail-Adresse des Organisationskontakts
container_id string Container-ID des Auftrags
container_name string Container-Name des Auftrags
cost string Auftragskosten
csr string CSR (Certificate Signing Request)
custom_renewal_message string Benutzerdefinierte Nachricht, die in die Verlängerungsbenachrichtigungen aufgenommen werden soll
customer_order_id string ID des Kundenauftrags
date_created string Datum des Auftrags
Format: yyyy-MM-dd HH:mm:ss
dcv_method string Die für die Domäne konfigurierte Methode zur Validierung der Domänenkontrolle
Siehe Glossar – DCV-Methoden
disable_issuance_email string Sollen Ausstellungsbenachrichtigungen gesendet werden?
Mögliche Werte: 0 (false), 1 (true)
disable_renewal_notifications string Sind Verlängerungsbenachrichtigungen aktiviert?
Mögliche Werte: 0 (false), 1 (true)
dns_names string Durch Kommas getrennte Liste der durch das Zertifikat geschützten zusätzlichen Namen.
email string Falls das Zertifikat eine eingebettete E-Mail-Adresse hat (z. B. Client-Zertifikate), wird die E-Mail-Adresse auf dem Zertifikat zurückgegeben.
firstname string Vorname des Organisationskontakts.
has_duplicates int Unterstützt das Produkt Duplikate?
Mögliche Werte: 0 (false), 1 (true)
id string Auftrags-ID
is_out_of_contract string Vertragsstatus des Auftrags
Mögliche Werte: 0 (false), 1 (true)
is_renewed string Wurde der Auftrag verlängert?
Mögliche Werte: 0 (false), 1 (true)
issuer_common_name string Anzeigename der ausstellenden Zertifizierungsstelle.
job_title string Funktion des Organisationskontakts.
lastname string Nachname des Organisationskontakts.
locale string Gebietsschema des Auftrags.
Siehe Glossar – Gebietsschemacodes
Metadaten Zeichenfolge Details des benutzerdefinierten Felds
Format: {{metadata_id}} {{metadata_label}} {{metadata_value}}Trennzeichen: 0x1f
org_addr1 string Organisationsadresse
org_addr2 string
organization_city string Stadt, in der sich die Organisation befindet
organization_country string Land, in dem sich die Organisation befindet
organization_id string Mit dem Auftrag verknüpfte Organisations-ID
organization_name string Organisationsname
organization_state string Bundesland, in dem sich die Organisation befindet
organization_unit string Organisationseinheiten auf dem Zertifikat
pay_type string Die für den Auftrag verwendete Zahlungsmethode
Mögliche Werte: A (Lastschrift), C (Kreditkarte)
plus_feature string Ist die Plus-Funktion für den Auftrag aktiviert?
Mögliche Werte: 0 (deaktiviert), 1 (aktiviert)
product_id string Produkt-ID
product_name string Anzeigename des Produkts
Siehe Glossar – Produkt-IDs
product_name_id string Name der Produkt-ID
Siehe Glossar – Produkt-IDs
product_type string Produkttyp.
Siehe Glossar – Produkttypen
purchased_dns_names string Anzahl der zusätzlich erworbenen SANs.
receipt_id string Beleg-ID
Renewed string Wurde der Auftrag verlängert?
Mögliche Werte: FALSE, TRUE
renewed_order_id string ID des vorherigen Auftrags.
Wird nur zurückgegeben, wenn der Auftrag eine Verlängerung ist.
serial_number string Seriennummer des Zertifikats
serversw string Serverplattform-ID
Siehe Glossar – Serverplattformen
signature_hash string Zum Signieren des Zertifikats verwendeter Signatur-Hashwert
status string Auftragsstatus
Siehe Glossar – Auftragsstatus
telephone string Telefonnummer des Organisationskontakts.
thumbprint string Fingerabdruck des Zertifikats
user_assignments string ID des Benutzers, der dem Auftrag zugewiesen ist
user_email string E-Mail-Adresse des Benutzers, der das Zertifikat beantragt hat
user_first_name string Vorname des Benutzers, der das Zertifikat beantragt hat
user_id string ID des Benutzers, der den Auftrag erteilt hat
user_last_name string Nachname des Benutzers, der das Zertifikat beantragt hat
valid_from string Datum des Beginns der Laufzeit des Zertifikats
Format: yyyy-MM-dd
valid_till string Datum des Laufzeitendes des Zertifikats
Format: yyyy-MM-dd
validity_years string Die Laufzeit des Zertifikats in Jahren

Reaktionsparameter

Name Typ Beschreibung
data object Container für zurückgegebene Abfragedaten.
.. order_details array Liste der Auftragsobjekte, die abgefragte Felder enthalten.
.. .. {{Feld}} - Abgefragtes Feld und Wert.
Zurückgegebene Felde in Abhängigkeit von der gesendeten Abfrage.