エラーの処理

Stamp API は、内部で Verify API を呼び出しています。 Verify API 側で何らかのエラーが発生した場合には、Stamp API では Verify API のエラーをレスポンスに含めて返します。 この場合、Stamp API 自体の呼び出しはエラーとなりません。

例えば、以下のようなレスポンスとなります。

{
  "results": [
    {
      "digitalSignature": {
        "request": {
          "content": "44CQ55Sz6L685pu444CRCuWIqeeUqOimj+e0hOOBq+WQjOaEj+OBl+OAgemBuOaKnuOBl+OBn+ODl+ODqeODs+OBq+eUs+OBl+i+vOOBv+OBvuOBmeOAggrjg5fjg6njg7M6IOmrmOmAn+ODl+ODqeODsw==",
          "printableContent": "ポケットサインターネットにお申し込みいただきありがとうございます。申込内容は以下のとおりです。\n\nプラン: 高速プラン"
        },
        "result": {
          "verification": {
            "id": "2f14c3e8-1333-4b8b-b8f6-f524eb4cf027",
            "result": "RESULT_CERTIFICATE_EXPIRED",
            "hashAlgorithm": "HASH_ALGORITHM_SHA256",
            "digest": "hLDwdaeUuH/V5q4aLjy2XD3aCyfysKlQE5ZHLzk3uEQ=",
            "signature": "MKaOBQ8I5cZVU7Chtv4nOtUaPgX3e0+47xpkeqEawHZ6lKUd8aZzkX3x+7Ux/4vNbE9hXNOuu+/jJvZHO85BDYluuz10BdWuKa5SoYVcxPHjVwi4JVwmC8V7DVsZs0X8jXuqFJD0U0m2a88Yidy0zAo1BKGGlAm50b99f1CH1CjJe3hpqgiNhBZNjdW0KfxzPBielr3fEwXoYoJwaLuREp4w/4Cu+aR0tBWux3J2pExzipNM3SJFubk/RUzxNk4Yxv3/0rFtREcisoX2PT1cPdSoxuCvws7/jHARzMQOUmp5g7E485Aq0Sas42lkC24prlJMCFaNPmbL0x6nJZoFpA==",
            "createdAt": "2023-12-19T15:32:41.004211Z"
          },
          "certificate": {
            "id": "72ec3527-e2f8-4fae-84cd-69e9b04cf84c",
            "type": "TYPE_JPKI_CARD_DIGITAL_SIGNATURE",
            "createdAt": "2023-09-19T08:36:24.424625Z"
          },
          "certificateContent": {
            "subject": "OU=P8N for digital signature+OU=PocketSign Inc.,O=P8N-MOCK,C=JP",
            "validity": {
              "notBefore": "2023-12-14T11:59:12Z",
              "notAfter": "2023-12-15T11:59:00Z"
            },
            "crlDistributionPoint": "CN=City-1869 CRLDP,OU=Prefecture-13,OU=CRL Distribution Points,OU=P8N for digital signature,O=P8N-MOCK,C=JP",
            "jpkiCardDigitalSignatureContent": {
              "commonName": "春日　太郎",
              "substituteCharacterOfCommonName": "00000",
              "gender": "1",
              "dateOfBirth": "520220829",
              "address": "東京都中央区日本橋室町三丁目４番４号",
              "substituteCharacterOfAddress": "000000000000000000"
            }
          },
          "user": {
            "id": "5504d1df-f24f-450e-92d8-14519d96c2b7",
            "createdAt": "2023-09-19T08:36:24.424625Z"
          },
          "isNewUser": false
        }
      }
    },
    {
      "personalInfoConsent": {
        "request": {
          "preference": {
            "commonName": true,
            "address": true,
            "dateOfBirth": true,
            "gender": true
          }
        },
        "error": {
          "code": 9,
          "message": "The request cannot proceed. Please refer to the documentation for more details.",
          "details": [
            {
              "@type": "type.googleapis.com/google.rpc.RequestInfo",
              "requestId": "025bcc2e-6a6b-4d8d-93e9-36989e14d088"
            },
            {
              "@type": "type.googleapis.com/google.rpc.ErrorInfo",
              "reason": "ERROR_REASON_CONSENT_SERVICE_CERTIFICATE_EXPIRED",
              "domain": "api.p8n.internal:50051"
            }
          ]
        }
      }
    }
  ],
  "metadata": {
    "nonce": "42f35d54-aa12-4a27-969f-b0f6fdef5b24"
  }
}

Verify API のエラー処理方法

Verify API が返すエラーのハンドリングは、エラー処理を参照してください。

Stamp API がエラーとなる場合

Verify API 側に問題がなく、Stamp API が何らかの理由で内部エラーとなった場合には、Stamp API 自体の呼び出しがエラーとなります。 その際のエラーハンドリング方法は Verify API に準じます。エラー処理を参照してください。