Bericht nach ID abrufen

GET
https://api.digicert.com/reports/v1/report/{{report_identifier}}

Verwenden Sie diesen Endpunkt, um Informationen über einen Bericht zurückzugeben, indem Sie eine Berichts-ID angeben.

Die Funktion „Berichtsbibliothek“ muss in Ihrem Konto aktiviert sein, damit dieser Endpunkt erfolgreich antworten kann.

cURL
curl -X GET \
  'https://www.digicert.com/services/v2/reports/preview/report/{{report_identifier}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

url = "https://www.digicert.com/services/v1/reports/preview/report/{{report-identifier}}"

payload={}
headers = {
  'Content-Type': 'application/json',
  'X-DC-DEVKEY': '{{api_key}}',
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
Go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://www.digicert.com/services/v1/reports/preview/report/{{report-identifier}}"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("X-DC-DEVKEY", "{{api_key}}")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
NodeJS
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://www.digicert.com/services/v1/reports/preview/report/{{report-identifier}}',
  'headers': {
    'Content-Type': 'application/json',
    'X-DC-DEVKEY': '{{api_key}}',
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
200 OK
{
    "report": {
        "report_display_name": "RPT01",
        "report_identifier": "b80de6e4-f085-4488-a47f-b7b5ea07e05e",
        "created_by_user_id": 10192361,
        "created_by_user_name": "venkat patil",
        "created_date": "2021-01-13 09:43:17",
        "report_metadata": {
            "columns": [
                {
                    "identifier": "account_id"
                },
                {
                    "identifier": "number_of_sans"
                },
                {
                    "identifier": "certificate_id"
                },
                {
                    "identifier": "certificate_validity_days"
                },
                {
                    "identifier": "container_id"
                },
                {
                    "identifier": "container_name"
                }
            ],
            "report_type": "orders"
        },
        "schedule": {
            "frequency": "WEEKLY", //Possible values ON_DEMAND,WEEKLY,MONTHLY
            "weekday_to_run": "WEDNESDAY", // Possible values SUNDAY to SATURDAY, ""
            "weekday_frequency": "", // Possible values FIRST, SECOND, THIRD, FOURTH, LAST, ""
            "run_until": "2021-12-23"
        },
        "next_run_date": "2021-01-20",
         "format": [
            "CSV" // Possible value only CSV
        ],
        "status": "ACTIVE"  // Always ACTIVE
    }
}
401 Invalid user
{
"code": "user_authentication_error",
"message": "User is not authenticated."
}
403 Forbidden
{
    "code": "user_forbidden",
    "message": "User does not have the required permission."
}
403 Not enabled
{
    "code": "custom_reports_not_enabled",
    "message": "Custom reports is not enabled"
}
404 Report not found
{
    "code": "reports_not_found",
    "message": "Report with the given identifier does not exist."
}
404 Page not found
404 page not found

Pfad-Parameter

Name Antr./Opt. Typ Beschreibung
report-identifier erforderlich string Berichts-ID, die in der Antwort der Create Report API angezeigt wird.

Reaktionsparameter

Name Typ Beschreibung
report object Container.
report_display_name string Der angegebene Name für den Bericht.
.. report_identifier string Berichts-ID, die in der Antwort der Create Report API angezeigt wird.
.. created_by_user_id string Die Benutzer-ID, die mit der Person verbunden ist, die den Bericht erstellt.
.. created_date string Das Erstellungsdatum des Berichts, einschließlich des Zeitstempels im Format: JJ-MM-TT HH-MM-SS.
.. created_by_user_name string Der Benutzername, der mit der Berichtserstellung verbunden ist.
.. report_metadata object Container.
.. .. columns object Im Bericht angegebene Spaltentypen.
.. .. .. identifier string Der Spaltenbezeichner, der von den APIs der Berichtsbibliothek unterstützt wird. Eine Liste aller unterstützten Spalten finden Sie unter Berichtsbibliothek API-Spalten.
.. .. report_type string Der Typ des Berichts.
.. schedule object Container.
.. .. frequency string Die Häufigkeit der Berichtserstellung. Mögliche Werte: ON_DEMAND, WEEKLY, MONTHLY. Bei den Werten wird zwischen Groß- und Kleinschreibung unterschieden.
.. .. weekday_to_run string Der Wochentag, an dem der Bericht erstellt werden soll. Mögliche Werte: SUNDAY bis SATURDAY. Bei den Werten wird zwischen Groß- und Kleinschreibung unterschieden.
.. .. weekday_frequency string Wie oft der Bericht pro Wochentag erstellt werden soll. Mögliche Werte: FIRST, SECOND, THIRD, FOURTH, LAST. Bei den Werten wird zwischen Groß- und Kleinschreibung unterschieden.
.. .. run_until date Das Datum, an dem die Erstellung des Berichts beendet werden soll. Format: JJ-MM-TT.
.. next_run_date date Das Datum, an dem die Erstellung des Berichts wiederaufgenommen werden soll. Format: JJ-MM-TT.
.. format string Das Format für den Bericht. Für diesen Endpunkt ist der mögliche Wert CSV. Um einen Bericht in JSON zurückzugeben, siehe Get JSON report API.
.. status string Der Status des Berichts. Alle geplanten Berichte sind ACTIVE.