PocketSign APIs
  1. verifications
PocketSign APIs
  • Verify API
    • v2
      • CertificateService
        • 証明書情報の取得
        • 証明書情報の検索
        • 証明書情報の削除
        • 証明書の失効確認
        • 証明書失効確認履歴の取得
        • 証明書失効確認履歴の検索
      • UserService
        • 利用者情報の取得
        • 利用者情報の検索
        • 利用者情報の削除
        • 利用者の現況確認
      • VerificationService
        • 署名検証
        • 署名検証結果の取得
        • 署名検証結果の検索
        • 署名検証結果の削除
    • v1
      • verifications
        • 署名検証
          POST
        • 署名検証結果の検索
          GET
        • 署名検証結果の取得
          GET
        • 署名検証結果の削除
          DELETE
      • certificates
        • 証明書データによる失効確認
        • 証明書情報の検索
        • 証明書情報の取得
        • 証明書情報の削除
        • 証明書IDによる失効確認
        • 失効確認履歴の取得
      • users
        • 利用者の検索
        • 利用者情報の取得
        • 利用者情報の削除
        • 利用者の現況確認
  1. verifications

署名検証結果の検索

廃止予定
モック環境
https://verify.mock.p8n.app
モック環境
https://verify.mock.p8n.app
GET
/verifications
verifications
保存されている検証結果を検索し、その結果を返します。

保存される情報#

署名検証を行うと、その結果が自動的に保存されます。
ただし、証明書に記載された情報(certificate_content)は当該APIを実行したときのみに返されます。このAPIを使用して後から結果を取得した際には返されません。

利用者IDの紐付け#

署名検証時に利用者の特定を要求せず、利用者IDが割り当てられなかった場合であっても、
別の署名検証時や失効確認時に利用者特定が要求され、証明書に紐付く利用者が特定された場合には、当該証明書にも新しく割り当てられた利用者IDが紐付けられます。
したがって、情報が保存された際には利用者IDが紐付けられていない場合であっても、本APIによる取得時には利用者IDが存在している場合があります。

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

Requestパラメータ

Queryパラメータ
limit
integer 
可選
取得する最大の件数
offset
integer 
可選
取得する位置
結果は作成日時の昇順でソートされています。
certificate_ids
array[string]
可選
取得する証明書IDのリスト
certificate_types
array[string]
可選
取得する証明書種別のリスト
user_ids
array[string]
可選
取得する利用者IDのリスト
created_since
string 
可選
作成日時の範囲指定(開始)
created_until
string 
可選
作成日時の範囲指定(終了)

サンプルコード

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://verify.mock.p8n.app/verifications'

Response

🟢200OK
application/json
Body
total
integer <int64>
必須
検索結果の総数
limit
integer <int64>
必須
取得する最大の件数
offset
integer <int64>
必須
取得する位置
results
array[object (GetVerificationsIdServerResponse) {4}] 
必須
verification
object (Verification) 
必須
検証結果
certificate
object (Certificate) 
可選
証明書データ
certificate_status
object (CertificateStatus) 
可選
証明書失効状態の確認結果
user
object (User) 
可選
利用者データ
例
{
  "total": 0,
  "limit": 0,
  "offset": 0,
  "results": [
    {
      "verification": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "result": "RESULT_UNSPECIFIED",
        "hash_algorithm": "sha256",
        "digest": "string",
        "signature": "string",
        "created_at": "2019-08-24T14:15:22Z"
      },
      "certificate": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "type": "jpki_card_digital_signature",
        "latest": true,
        "created_at": "2019-08-24T14:15:22Z"
      },
      "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"
      },
      "user": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "created_at": "2019-08-24T14:15:22Z"
      }
    }
  ]
}
🟠400400
🟠401401
🔴500500
前へ
署名検証
次へ
署名検証結果の取得
Built with