API チュートリアル

初級編

1. postmanインストールしてください

※postman推奨と言う訳ではありません。
https://www.postman.com/

2. sunabar用Swaggerファイルをダウンロード(拡張子は.json)

swaggerファイル:sunabar_Open API.postman_collection.json

環境変数(個人) :sunabar_個人設定.postman_environment.json

環境変数(法人) :sunabar_法人設定.postman_environment.json

3. PostmanへSwaggerファイルをインポート

ⅰ. postman左上部にある「import」ボタンを押下

ⅱ. IMPORTダイアログが表示

ⅲ. 目的のSwaggerファイルをドラッグ&ドロップ 

ⅳ. インポート確認ダイアログが表示されるので「Import as Copy」を押下

ⅴ. 左側にインポートされた情報が表示

4. 環境変数の設定

ⅰ. 環境変数ファイルをダウンロード

環境変数(個人) :sunabar_個人設定.postman_environment.json

環境変数(法人) :sunabar_法人設定.postman_environment.json

ⅱ. Postman右上部の設定マークを押下

ⅲ. 「import」ボタンを押下

ⅳ. 「ファイル選択」ボタンを押下

ⅴ. ダウンロードした環境変数ファイルを選択して、「開く」ボタンを押下

ⅵ. 環境変数が読み込まれれば完了

【option】環境変数の確認

ⅰ. Postman右上部のドロップダウンリストを選択して任意の設定を選択

ⅱ. URLの{{}}の環境変数名にフォーカスを合わせるて、 CURRENTに現在の設定内容が表示されていることを確認

【option】リクエストパラメータの追加・変更

実行APIに応じて適宜 リクエストパラメータの追加・変更を行ってください。

ⅰ. 追加・変更したい環境変数を押下

ⅱ. 変数定義を編集

・変数名 ・・・ リクエストパラメータ名を設定
・初期値 ・・・ リクエストパラメータの初期値
・現在値 ・・・ リクエストパラメータの現在値で、頻繁に値を変更する場合に利用
変更後は必ず「Update」ボタンを押下して更新を反映してください。

5. sunabarポータルサイトへログイン

https://portal.sunabar.gmo-aozora.com/login

6. sunabarポータルサイト TOP

7. sunabar用銀行口座画面でアクセストークンコピー

8. postman左欄”sunabar Open API”から”口座一覧照会”を選択

9. postman右の環境変数”sunabar_個人設定”から
『x-accrss-token』の"CURRENT VALUE"に”7”で取得したアクセストークンを入力

10. postmanの右上”send”ボタンを押下し、口座一覧照会API呼出