Richiedi report per ID

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

Usa questo endpoint per riportare delle informazioni su un report fornendo un ID report.

La funzione Libreria report deve essere abilitata nel tuo account affinché questo endpoint risponda correttamente.

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

Parametri percorso

Nome Rich/Opz Tipo Descrizione
report-identifier obbligatorio string ID report visualizzato nella risposta dell’API Crea report.

Parametri di risposta

Nome Tipo Descrizione
report object Contenitore.
report_display_name string Il nome specificato per il report.
.. report_identifier string ID report visualizzato nella risposta dell’API Crea report.
.. created_by_user_id string ID utente associato alla persona che crea il report.
.. created_date string La data di creazione del report, compresa la data e l’ora nel formato: AA-MM-GG HH--MM-SS.
.. created_by_user_name string Username associato alla creazione report.
.. report_metadata object Contenitore.
.. .. columns object Tipi di colonne specificati nel report.
.. .. .. identifier string L’identificatore colonna supportati dalle API Libreria report. Per un elenco di tutte le colonne supportate, consulta Colonne API libreria report.
.. .. report_type string Tipo di report.
.. schedule object Contenitore.
.. .. frequency string La frequenza della creazione del report. Valori possibili: ON_DEMAND, WEEKLY, MONTHLY. I valori osservano le maiuscole/minuscole.
.. .. weekday_to_run string Il giorno della settimana per creare il report. Valori possibili: Da SUNDAY a SATURDAY. I valori osservano le maiuscole/minuscole.
.. .. weekday_frequency string Numero di volte per creare il report ogni giorno feriale. Valori possibili: FIRST, SECOND, THIRD, FOURTH, LAST. I valori osservano le maiuscole/minuscole.
.. .. run_until date La data in cui interrompere la creazione di questo report. Formato: AA-MM-GG.
.. next_run_date date La data in cui riprendere la creazione di questo report. Formato: AA-MM-GG.
.. format string Formato per il report. Per questo endpoint, il valore possibile è CSV. Per riportare un report in JSON, consulta l’API Richiedi report JSON.
.. status string Stato del report. Tutti i report programmati sono ACTIVE.