SSL証明書の一覧
URI
https://api.scutum.jp/api/v1/cert
APIの概要
SSL証明書の一覧を取得します。
<呼び出しリクエストの例>
GET /api/v1/cert?host=www.example.jp&id=ABC1234 HTTP/1.1
X-Scutum-API-Key: 17a1f5d161b33b6404faa8f8ccfdfdf2edf
Host: api.scutum.jp
Connection: close
X-Scutum-API-Key: 17a1f5d161b33b6404faa8f8ccfdfdf2edf
Host: api.scutum.jp
Connection: close
URLパラメータ一覧
| パラメータ名 | 必須 | 説明 |
|---|---|---|
| host | ✔ | APIキーを発行したFQDNです。 |
| id | ✔ | Scutum管理画面のIDです。 APIキーを発行したFQDNと対応する管理画面IDを指定してください。 |
呼び出し結果のレスポンス例
リクエストが成功すると、レスポンスで以下のようなjsonが返ります。
{
"cert_list": [
{
"note": "この証明書は 2026/01/22 11:30:42 にアップロードされました。",
"upload_date": "2026-01-22T11:30:42+09:00",
"subject": "CN=*.example.jp",
"cert_id": "69718bd1091e146754806f47",
"not_after": "2023-09-10T19:53:01+09:00",
"not_before": "2022-08-09T19:53:02+09:00"
},
{
"note": "この証明書は 2026/01/19 16:07:48 にアップロードされました。",
"upload_date": "2026-01-19T16:07:48+09:00",
"subject": "CN=*.example.jp",
"cert_id": "696dd843091e146754806f46",
"not_after": "2023-09-10T19:53:01+09:00",
"not_before": "2022-08-09T19:53:02+09:00"
},
{
"note": "この証明書は 2025/11/20 11:07:21 にアップロードされました。",
"upload_date": "2025-11-20T11:07:21+09:00",
"subject": "CN=www.example.jp,OU=開発部,O=株式会社サンプル,L=千代田区,ST=東京都,C=JP",
"cert_id": "691e77f9091e146754806f44",
"not_after": "2023-09-10T19:53:01+09:00",
"not_before": "2022-08-09T19:53:02+09:00"
}
]
}
レスポンスに含まれるパラメータ一覧
| パラメータ | データ型 | 説明 |
|---|---|---|
| cert_list | array | 証明書のリストです。現在Scutum上で使用される証明書がリストにある場合は、それが必ずリストの最初の要素になります。 |
| note | string | 証明書ごとに設定可能なメモにあたる内容です。デフォルトではアップロードされた日を示す文章が入ります。 |
| upload_date | string | アップロードされた日時です。 |
| subject | string | 証明書のSubjectです。 |
| cert_id | string | 証明書ごとに一意となるidを示す文字列です。証明書の詳細APIや削除APIを呼び出す際に必要になります。 |
| not_before | string | 証明書の有効期限の最初の日時です。 |
| not_after | string | 証明書の有効期限の最後の日時です。 |