Obtener informe por Id.

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

Use este terminal para devolver una información sobre un informe suministrando una Id. de informe.

La función Biblioteca de informes debe estar habilitada en su cuenta para que este terminal responda correctamente.

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

Parámetros de la ruta

Nombre Solicitud/opción Tipo Descripción
report-identifier obligatorio string Id. de informe mostrada en la respuesta de la API crear informe.

Parámetros de la respuesta

Nombre Tipo Descripción
report object Contenedor.
report_display_name string El nombre especificado para el informe.
.. report_identifier string Id. de informe mostrada en la respuesta de la API crear informe.
.. created_by_user_id string La Id. de usuario asociada con la persona que crea el informe.
.. created_date string La fecha de creación del informe, incluida la marca de tiempo en formato: AA-MM-DD HH--MM-SS.
.. created_by_user_name string El nombre de usuario asociado con la creación del informe.
.. report_metadata object Contenedor.
.. .. columns object Tipos de columnas especificadas en el informe.
.. .. .. identifier string El identificador de columna admitido por las API de la biblioteca de informes. Para obtener una lista de todas las columnas admitidas, consulte Columnas API de la biblioteca de informes.
.. .. report_type string El tipo de informe.
.. schedule object Contenedor.
.. .. frequency string La frecuencia de creación de informes. Posibles valores: ON_DEMAND, WEEKLY, MONTHLY. Los valores distinguen mayúsculas de minúsculas.
.. .. weekday_to_run string El día de la semana para crear el informe. Posibles valores: SUNDAY a SATURDAY. Los valores distinguen mayúsculas de minúsculas.
.. .. weekday_frequency string El número de veces en las que se creará el informe por día de semana. Posibles valores: FIRST, SECOND, THIRD, FOURTH, LAST. Los valores distinguen mayúsculas de minúsculas.
.. .. run_until date La fecha para detener la creación de este informe. Formato: AA-MM-DD.
.. next_run_date date La fecha para reanudar la creación de este informe. Formato: AA-MM-DD.
.. format string El formato del informe. Para este terminal, el posible valor es CSV. Para devolver un informe en JSON, consulte la API obtener informe en JSON.
.. status string El estado del informe. Todos los informes programados son ACTIVE.