Empowering API Quality with Postman & AI-Genetated OpenAPI at Kyash

https://postman.connpass.com/event/379160/

Transcript

1. ©2026 Kyash Inc. ©2026 Kyash Inc. KyashにおけるAIから生成したOpenAPIとPostman mockの使い方 Empowering API Quality with Postman & AI-Generated OpenAPI at Kyash 2026.03更新 Masaya Bando (Kyash Inc.) @unionsep Postman API Night Tokyo 2026 Spring
2. ©2026 Kyash Inc. 2 Empowering API Quality with Postman & AI-Genetated OpenAPI at Kyash 1. About the Speaker 2. Who here knows Kyash 3. Credit division 4. Postman mock server 5. Future 6. Closing Table of contents
3. ©2026 Kyash Inc. ©2026 Kyash Inc. About Me 3 3
4. ©2026 Kyash Inc. 4 Empowering API Quality with Postman & AI-Genetated OpenAPI at Kyash About Me KyashでSoftware Engineer in Test (QA) とし て開発業務も担当しています。Backend (SWE)を行 いながら、組織に品質文化を浸透させる役割も担ってい ます。 好きなGo Package はreflectです Go Gopher by Renée French is licensed under CC BY 3.0.
5. ©2026 Kyash Inc. ©2026 Kyash Inc. Who here knows Kyash? 5 5
6. ©2026 Kyash Inc. Kyashは、スマホで支払いとお金の管理ができるVisaプリペイ ドカードアプリです。 共有口座を使って他のユーザーと残高を共有できたり、支払いに使うだけで お金の管理ができる家計簿をつけられたり、最小1円から必要な分だけ借り て入金できたりします。 6 スポットマネー https://www.kyash.co/services/spotmoney Kyashしってますか 家計簿 https://www.kyash.co/services/pfm 共有口座 https://www.kyash.co/services/share-account
7. ©2026 Kyash Inc. ©2026 Kyash Inc. この範囲に画像を配置する Feel free to Download!
8. ©2026 Kyash Inc. 8 • Kyashは堅牢な決済基盤を新しい技術で自社開発している • 電文のオーソリのクリアリングにおけるマッチング処理とか • 入金トランザクションに対するリコンサイル処理とか • Kyashの 特徴（強み） とは ※ Fintechなので金融に関する機能にフォーカスが当たりがち
9. ©2026 Kyash Inc. 9 銀行入金 モバイルアプリ eKYC バーチャル口座 ATM入出金 カード発行 銀行出金 ApplePay/Google Pay 法人送金 App Logs & Metrics クレジットカード決済 クレジットカードチャージ ネット口座振込 リワード 不正検知 ローン 3D Secure クレジットカード登録 BNPL
10. ©2026 Kyash Inc. 10 ※ １回あたりのトランザクションに関わる外部APIの呼び出し回数は、入金３回、決済４回で計算しています 1日４２６,000回（1秒5回）API通信 決済トランザクション 84,000件 / 日 入金トランザクション 30,000件 / 日 Kyashは1日におおよそ84,000件の決済、30,000件の入金に関わるトランザクションが発生します。1回 あたり3〜4回の外部APIを呼び出す必要があり、1日あたり4２６,000回、外部APIに依存しています。 336,000 external API calls 90,000 external API calls ※ もちろん、外部APIに依存している機能は、決済/入金だけではありません
11. ©2026 Kyash Inc. 11 KyashはAPIリクエストをいっぱい送信 し、APIレスポンスをいっぱい受信して います。 ※ Fintechということもあり、外部API依存度が高いサービスとなります。
12. ©2026 Kyash Inc. “ ” 12 つまり、Kyashは外部APIを組み合わせてFintech サービスを提供しているAPIオーケストレーションプラッ トフォームと言えると思います。 APIファーストもとい、APIインポータント
13. ©2026 Kyash Inc. ©2026 Kyash Inc. Credit division 13 13
14. ©2026 Kyash Inc. Credit division 14 イマすぐ入金やスポットマネーなどの与信プロダクトを担当する事業部です。GeNiE株式会社と共創モデルのプロダクト として発足し、開発を進めています。 スポットマネー https://www.kyash.co/services/spotmoney
15. ©2026 Kyash Inc. 共創モデルとは、共に創るモデルです 共に創るということは、私たちが開発する場面において、テスト環境がないことを意味します。 VISAや銀行などに接続する場合、テスト環境が提供されており、私たちは提供されているテスト環境に向けて動作確認を 行い、開発を進めればよかったのですが、共創モデルは相手となるテスト環境がありません。 15 ※ もちろん、GeNiE様はKyashの開発が終わらないとテストできません
16. ©2026 Kyash Inc. ©2026 Kyash Inc. Postman mock server 16 16
17. ©2026 Kyash Inc. Postman mock serverが ありがたかった 共創モデルは開発を進めるにあたって試行錯誤する相 手がいません。仕様書は提供していただいています が、GeNie APIが完成しないとテストできません。 外部結合テスト（ITb）で仕様理解不足や認識齟齬が多 発し、チームは疲弊している状況でした。 17 https://learning.postman.com/latest-v-12/docs/getting-started/bas ics/postman-elements#mock-servers
18. ©2026 Kyash Inc. Postman mock server には助けてもらったけど、もっと 活用できないか 18 API仕様書はExcelやPDFで提供頂いています。変更があった場合、更新バージョンを都度、作成してもらっています。共 創モデルなので、変更や更新は割りと頻繁にあります。そのたびにPostmanのCollectionをWebから更新するのは面 倒くさいしヌケモレが発生しそうです。 PostmanはOpenAPIを読み込めるので、これをうまいこと使えないか • ExcelやPDFをYAMLに変換 • 内容に不備がないか人間がレビュー • マージする • HTML出力
19. ©2026 Kyash Inc. 19 作りました Push Click Run workflow Pull Request Review Collections Github Pages
20. ©2026 Kyash Inc. 20 GeNiE様から最新のAPI仕様書をPDFで受け取ったら、Githubリポジトリにコ ミットします。 その後、手動実行（workflow_dispatch）できるActionsを実行し、Claudeに 読み込んでもらってOpenAPI形式のyamlファイルを生成してもらいます。
21. ©2026 Kyash Inc. 21 Claudeが生成したyamlファイルをcommitした PullRequest。AIが仕様書を読んで生成したも のなので、人間がレビューします。 チームメンバーでレビューするため、各メンバーの 読み違えや読み落としを軽減し、仕様理解の促進の 効果を期待しています。
22. ©2026 Kyash Inc. 22 yamlファイルをマージしたら内部公開している Github PagesのHTMLファイルを生成する PullRequestが作られます。 HTMLファイルは直接コミットしても良いのです が、対象ブランチは直接コミットを制限しているの で、PR経由でmergeするルールにしています。
23. ©2026 Kyash Inc. 23 Github Pagesで内部公開しているページはStoplightのデザインを採用しま した。ReDocやSwagger UIでも良かったのですが、なんとなく直感で Stoplightがわかりやすく感じました。
24. ©2026 Kyash Inc. ©2026 Kyash Inc. Feature 24 24
25. ©2026 Kyash Inc. マニュアルテストの依存度を下げたい KyashとGeNiEの開発フローにおける課題感は、Kyash内部でも発生しています。モバイルメンバーとバックエンドメン バーでも同様の課題は古くから存在していましたが、社内のコミュニケーションでカバーできていた部分です。 25 api funds payment fraud kyc loan issuing crypto banks admin timeline payout withdra wal login lending account
26. ©2026 Kyash Inc. Serverだけでテストを完結できる仕組みを作りたい KyashのサーバーはWeb UIをほとんど提供していません。ほぼ全てAPIのI/Oで構成されるため、モジュールアップ デートやバージョンアップにおけるマニュアルテストは不要なはずですが、マニュアルテストに頼っている状況です。 26 api funds payment fraud kyc loan issuing crypto banks admin timeline payout withdra wal login lending account
27. ©2026 Kyash Inc. ©2026 Kyash Inc. Closing 27 27
28. ©2026 Kyash Inc. • Kyashでは、1日約11万件のトランザクション を処理している • 1日約42万回の外部API通信が発生 • Fintechは外部APIとの連携が不可欠 • Postman Mock Serverによって、パート ナーAPIのテストを改善 • AIを使って仕様書からOpenAPIを生成して運 用フローを改善した 28 Lessons learned
29. ©2026 Kyash Inc. 29 WE ARE HIRING! Check : https://www.kyash.co/recruit X : https://www.kyash.co/recruit
30. ©2026 Kyash Inc. ©2026 Kyash Inc. Thank you 2026.3.12 Masaya Bando (Kyash Inc.) X: @unionsep 30