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)

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`.

Parámetros de la ruta

Parámetros de la respuesta

Acerca de nosotros