ID로 보고서 받기

GET

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

이 엔드포인트를 사용하여 보고서 ID를 제공하여 보고서에 대한 정보를 반환합니다.

이 엔드포인트가 응답하려면 계정에 보고서 라이브러리 기능을 사용해야 합니다.

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

경로 매개 변수

이름	필수/옵션	유형	설명
report-identifier	필수	string	보고서 만들기 API의 응답에 표시하는 보고서 ID입니다.

응답 매개 변수

이름	유형	설명
report	object	컨테이너입니다.
report_display_name	string	보고서에 지정한 이름입니다.
.. report_identifier	string	보고서 만들기 API의 응답에 표시하는 보고서 ID입니다.
.. created_by_user_id	string	보고서를 만드는 사용자에게 연결된 사용자 ID입니다.
.. created_date	string	보고서를 만든 날짜로 타임스탬프를 포함하며 형식은 YY-MM-DD HH--MM-SS입니다.
.. created_by_user_name	string	보고서 만들기에 연결된 사용자 이름입니다.
.. report_metadata	object	컨테이너입니다.
.. .. columns	object	보고서에 지정한 열의 유형입니다.
.. .. .. identifier	string	보고서 라이브러리 API에서 지원하는 열 식별자입니다. 모든 지원하는 열의 목록은 보고서 라이브러리 API 열을 참조하십시오.
.. .. report_type	string	보고서 유형입니다.
.. schedule	object	컨테이너입니다.
.. .. frequency	string	보고서 만들기의 주기입니다. 가능한 값: `ON_DEMAND, WEEKLY, MONTHLY`. 값은 대/소문자를 구분합니다.
.. .. weekday_to_run	string	보고서를 만드는 요일입니다. 가능한 값: `SUNDAY` ~ `SATURDAY`입니다. 값은 대/소문자를 구분합니다.
.. .. weekday_frequency	string	평일마다 보고서를 만드는 횟수입니다. 가능한 값: `FIRST`, `SECOND`, `THIRD`, `FOURTH`, `LAST`. 값은 대/소문자를 구분합니다.
.. .. run_until	date	보고서의 만들기를 중지하는 날짜입니다. 형식: YY-MM-DD입니다.
.. next_run_date	date	보고서의 만들기를 다시 시작하는 날짜입니다. 형식: YY-MM-DD입니다.
.. format	string	보고서의 형식입니다. 이 엔드포인트에서 가능한 값은 `CSV`입니다. 보고서를 JSON으로 반환하려면 JSON 보고서 받기 API를 참조하십시오.
.. status	string	보고서의 상태입니다. 예약된 보고서는 `ACTIVE`입니다.