B BankcodeJP API Reference
Quick Start

最初の実装までの最短手順

APIキーを取得し、Search API と Resolve API β を実際に呼び出すまでの最小手順です。

1. APIキーを取得する

APIキーは BankcodeJP API のダッシュボードから取得できます。アカウント作成後、ダッシュボードにログインし、APIキーを確認してください。

ダッシュボードを開く

2. 環境変数に設定する

export BANKCODEJP_API_KEY='YOUR_API_KEY'

3. 金融機関一覧を取得する

curl -sS "https://apis.bankcode-jp.com/v3/banks?limit=3&apikey=${BANKCODEJP_API_KEY}" | jq

4. 支店情報を取得する

curl -sS "https://apis.bankcode-jp.com/v3/banks/0001/branches/001?apikey=${BANKCODEJP_API_KEY}" | jq

5. filterで検索する

日本語を含むクエリはURLエンコードしてください。curlでは --get と --data-urlencode を推奨します。

curl -sS --get "https://apis.bankcode-jp.com/v3/banks"   --data-urlencode "filter=hiragana==*みずほ*"   --data-urlencode "limit=5"   --data-urlencode "apikey=${BANKCODEJP_API_KEY}" | jq

6. 銀行名・支店名を解決する

curl -sS -X POST   "https://apis.bankcode-jp.com/resolve/v1/bank-branch?apikey=${BANKCODEJP_API_KEY}"   -H "content-type: application/json"   --data '{
    "bank_name": "みずほ銀行",
    "branch_name": "東京営業部",
    "context": "default"
  }' | jq

decision が auto_confirm の場合は最有力候補を採用できます。needs_review / ambiguous の場合は候補確認フローを挟んでください。

次に読むページ