失効確認履歴の取得

廃止予定

モック環境

https://verify.mock.p8n.app

GET

/certificates/{id}/status

指定されたIDをもとに当該証明書の失効確認履歴を取得します。

失効確認の目的

署名検証の過程で実施された失効確認は、check_purpose が signature_verification (署名検証)として記録されます。
証明書データによる失効確認や証明書IDによる失効確認、利用者の現況確認の場合は、check_purpose が liveness_check (現況確認)として記録されます。

これらは、関係機関への報告のために利用されます。
また、PocketSign Verify APIの利用料金計算にも利用されます。

削除

失効確認履歴は、証明書情報の削除を行うと同時に削除されます。

リクエストとレスポンスの詳細

Requestパラメータ

Pathパラメータ

string

必須

証明書ID

Queryパラメータ

limit

integer

可選

取得する最大の件数

offset

integer

可選

取得する位置

結果は作成日時の昇順でソートされています。

サンプルコード

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Response

🟢200OK

application/json

Body

total

integer <int64>

必須

検索結果の総数

limit

integer <int64>

必須

取得する最大の件数

offset

integer <int64>

必須

取得する位置

results

array[object (GetCertificatesIdStatusIdServerResponse) {1}]

必須

検索結果

certificate_status

object (CertificateStatus)

必須

証明書失効状態の確認結果

例

{
    "total": 0,
    "limit": 0,
    "offset": 0,
    "results": [
        {
            "certificate_status": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "status": "good",
                "check_method": "crl",
                "check_purpose": "signature_verification",
                "source_updated_at": "2019-08-24T14:15:22Z",
                "revoked_at": "2019-08-24T14:15:22Z",
                "revocation_reason": "unspecified",
                "created_at": "2019-08-24T14:15:22Z"
            }
        }
    ]
}

🟠400400

🟠401401

🟠404404

🔴500500

更新日時 2023-09-02 19:36:48

証明書IDによる失効確認

利用者の検索

失効確認履歴の取得

失効確認の目的#

削除#

リクエストとレスポンスの詳細#

Requestパラメータ

サンプルコード

Response

失効確認の目的

削除

リクエストとレスポンスの詳細