SSL 証明書 APIリファレンス

得られるもの

発行者、有効性、セキュリティグレードを含む SSL 証明書情報を取得します。

同期一括RESTMCPSDKインタラクティブツール

この製品を選ぶ場面

対象ユーザー

権限のあるテストや人によるレビューの代わりではなく、範囲を限定した受動検査でトリアージと調査を補強します。

この製品を選ぶ場面

公開TLS証明書の証拠、有効性、名前、チェーン関連シグナルを利用可能な範囲で調べるときに選びます。

得られるもの

発行者、有効性、セキュリティグレードを含む SSL 証明書情報を取得します。

エンドポイント

統合する前に、サポートされる操作、入力、出力、実行モード、レスポンス制限を確認してください。

GET /v1/certificates APIリファレンスを見る

POST /v1/certificates/bulk APIリファレンスを見る

GET /v1/ssl/audit APIリファレンスを見る

GET /v1/ssl/deep-scan APIリファレンスを見る

GET /v1/ssl/grade APIリファレンスを見る

GET /v1/ssl/chain APIリファレンスを見る

GET /v1/ssl/expiring APIリファレンスを見る

クレジットと認証

1-10 認証が必要。正確な料金と項目ごとの料金については、操作リファレンスを確認してください。

操作例

文書化された操作を使って、公開証拠を収集、評価、補足、検証、比較、保護、監視します。

GET /v1/certificates

クエリパラメータ

パラメータ	タイプ	必須
domain	string	必須
include_subdomains	boolean デフォルト `true`	オプション
include_expired	boolean デフォルト `false`	オプション
limit	integer デフォルト `100`	オプション
cursor	string	オプション

レスポンスフィールド

フィールド	タイプ
`domain`	string
`certificates[]`	object[]
`certificates[]`	object
`certificates[].id`	string
`certificates[].issuer`	object
`certificates[].common_name`	string
`certificates[].san[]`	string[]
`certificates[].not_before`	string
`certificates[].not_after`	string
`certificates[].is_expired`	boolean
`certificates[].is_wildcard`	boolean
`certificates[].fingerprint_sha256`	string
`summary`	object
`summary.total_found`	integer
`summary.returned`	integer
`summary.unique_subdomains`	integer
`summary.issuers[]`	string[]
`summary.earliest_cert`	string \| null
`summary.latest_cert`	string \| null
`pagination`	object
`pagination.limit`	integer
`pagination.offset`	integer
`pagination.returned`	integer
`pagination.total`	integer
`pagination.has_more`	boolean
`pagination.next_cursor`	string \| null
`intelligence_summary`	object
`intelligence_summary.data_source`	string
`intelligence_summary.ct_log_sources[]`	string[]
`intelligence_summary.source_count`	integer
`intelligence_summary.cache_status`	string
`intelligence_summary.returned_count`	integer
`intelligence_summary.total_found`	integer
`intelligence_summary.truncated`	boolean
`intelligence_summary.limit`	integer
`intelligence_summary.include_subdomains`	boolean
`intelligence_summary.include_expired`	boolean
`intelligence_summary.unique_name_count`	integer
`intelligence_summary.unique_subdomains`	integer
`intelligence_summary.issuer_count`	integer
`intelligence_summary.wildcard_cert_count`	integer
`intelligence_summary.active_cert_count`	integer
`intelligence_summary.expired_cert_count`	integer
`intelligence_summary.expiring_within_30_days_count`	integer
`intelligence_summary.earliest_cert`	string \| null
`intelligence_summary.latest_cert`	string \| null
`intelligence_summary.latest_expiry`	string \| null
`intelligence_summary.has_more`	boolean
`intelligence_summary.next_cursor`	string \| null
`intelligence_summary.warning_code`	string \| null
`meta`	object

リクエスト例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=100"

レスポンス例

{
  "domain": "example.com",
  "certificates": [
    {
      "id": "example-id",
      "issuer": {},
      "common_name": "example",
      "san": [
        "example"
      ],
      "not_before": "2026-08-27T12:00:00Z",
      "not_after": "2026-08-27T12:00:00Z",
      "is_expired": false,
      "is_wildcard": false,
      "fingerprint_sha256": "example"
    }
  ],
  "summary": {
    "total_found": 1,
    "returned": 1,
    "unique_subdomains": 1,
    "issuers": [
      "example"
    ],
    "earliest_cert": "example",
    "latest_cert": "example"
  },
  "pagination": {
    "limit": 1,
    "offset": 1,
    "returned": 1,
    "total": 1,
    "has_more": false,
    "next_cursor": "example"
  },
  "intelligence_summary": {
    "data_source": "public_data",
    "ct_log_sources": [
      "example"
    ],
    "source_count": 1,
    "cache_status": "live",
    "returned_count": 1,
    "total_found": 1,
    "truncated": false,
    "limit": 1,
    "include_subdomains": false,
    "include_expired": false,
    "unique_name_count": 1,
    "unique_subdomains": 1,
    "issuer_count": 1,
    "wildcard_cert_count": 1,
    "active_cert_count": 1,
    "expired_cert_count": 1,
    "expiring_within_30_days_count": 1,
    "earliest_cert": "example",
    "latest_cert": "example",
    "latest_expiry": "example",
    "has_more": false,
    "next_cursor": "example",
    "warning_code": "example"
  },
  "meta": {}
}