銀行・支店名の全件目視確認を、確認が必要な入力に絞り込む。

curl

curl -s -X POST "https://apis.bankcode-jp.com/resolve/v1/bank-branch" \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "X-API-KEY: ${BANKCODEJP_API_KEY}" \
  -d '{"bank_name":"住信SBIネット銀行","branch_name":"USEN","context":"default"}' | jq

needs_review レスポンス例

{
  "decision": "needs_review",
  "best_match": {
    "bank_code": "0038",
    "bank_name": "住信SBIネット銀行",
    "branch_code": "208",
    "branch_name": "USEN支店"
  },
  "candidates": [
    {
      "bank_code": "0038",
      "bank_name": "住信SBIネット銀行",
      "branch_code": "208",
      "branch_name": "USEN支店"
    },
    {
      "bank_code": "0038",
      "bank_name": "住信SBIネット銀行",
      "branch_code": "302",
      "branch_name": "USEN法人支店"
    }
  ],
  "reason_codes": [
    "branch_alias_ambiguous",
    "gap_too_small"
  ],
  "reason_details": [
    {
      "code": "branch_alias_ambiguous",
      "message_ja": "支店名の略称が同一銀行内の複数支店に該当する可能性があります"
    }
  ],
  "reason_summary_ja": "支店名の略称が同一銀行内の複数支店に該当する可能性があります"
}

unresolved レスポンス例

{
  "decision": "unresolved",
  "candidates": [],
  "reason_codes": [
    "bank_not_found"
  ],
  "reason_details": [
    {
      "code": "bank_not_found",
      "message_ja": "入力された銀行名に一致する金融機関候補を特定できません"
    }
  ],
  "reason_summary_ja": "入力された銀行名に一致する金融機関候補を特定できません"
}

unresolvedでは候補を特定できないため、candidatesは空配列です。best_matchは返りません。