Upgrade to Pro — share decks privately, control downloads, hide ads and more …

HTTP QUERY時代の型安全な検索APIをKotlinで設計する

Sponsored · SiteGround - Reliable hosting with speed, security, and support you can count on. →
SansanTech PRO
November 14, 2026

HTTP QUERY時代の型安全な検索APIをKotlinで設計する

■イベント
Kotlin Fest 2026
https://2026.kotlinfest.dev/

■登壇概要
タイトル:HTTP QUERY時代の型安全な検索APIをKotlinで設計する
登壇者:技術本部 Bill One Service Platform プロダクト開発部 Transaction Detailグループ 近藤 成人

■ 技術本部 採用情報
https://media.sansan-engineering.com

SansanTech PRO

November 14, 2026

Transcript

39 slides
  1. 近藤 成⼈(Naruto Kondo) Bill One Service Platform プロダクト開発部 Transaction Detailグループ

    25卒のソフトウェアエンジニア 複数社でのインターンを経てSansanに新卒⼊社 ⼊社から現在に⾄るまで、仕訳領域のプロダクト開発に従事 Kotlin歴は3年です
  2. Bill Oneのバックエンドの構成 - マイクロサービスアーキテクチャを採⽤している - バックエンドの実⾏環境は Cloud Run - 各サービスは

    Kotlin / Ktor 等で実装 - DBアクセスは ORM ではなく JDBIを採⽤している - SQLを組み⽴て、JDBI で値をバインドして実⾏する
  3. HTTP Methodの意味論としての⽴ち位置 「安全な参照(GET)」の性質を維持したまま、「ボディ(POST)」をもてる ボディ サーバー変更 (副作⽤) 意味論 (本来の役割) GET なし

    なし(安全) リソースの参照 POST あり あり リソースの作成等 QUERY あり なし(安全) 複雑な条件による リソースの参照 ※ IETF RFC 10008 The HTTP QUERY Method https://www.rfc-editor.org/rfc/rfc10008.html#section-5.1
  4. 検索条件は性質の異なる2種類があった 単純な絞り込み 業務ルールを含む条件 - 形: 列と値の⼆項演算(ANDで連結) - 形: 複数の条件をORで束ね、ANDで連結 -

    例: [条件A] AND [条件B] - 例: ([条件P] OR [条件Q]) AND [条件A] - 性質: パラメータの指定 - 性質: 業務ルールによる絞り込み
  5. 判断1: 内部的なOR条件をwhereの中に⼊れるかどうか 業務ルールをWhereから切り離し、判定ロジックを呼び出し側に書かせない whereの中に⼊れる 別出しにする(採⽤) 形: ⼊れ⼦のand/orツリー 形: whereは⼆項演算のANDのみ 指定⽅法:

    呼び出し側がOR条件を⾃由に組み⽴てる 指定⽅法: ORを含む条件はwhereとは別に置く 課題: 利点: - 内部仕様が呼び出し側に漏れる - 呼び出し側は内部仕様を知らなくていい - 条件が複雑化し、型定義がAnyに崩れやすい - Whereをシンプルな型で守れる
  6. 案2 汎⽤オブジェクト(field / op / value) field / op /

    value を配列で渡す リクエスト(JSON) Kotlin 項⽬は⾜しやすい / 型安全性が失われ、無意味な条件が書けてしまう
  7. Cloud Run環境でQUERYが通らない 当時のCloud Run環境では、QUERYリクエストが502となり、 アプリケーションまで届かなかった 呼び出し元 呼び出し元 QUERY POST HTTP/2

    502 Bad Gateway reset reason: protocol error Google Cloudの リクエスト処理基盤 アプリケーション(Ktor) ※ GCP Issue Tracker: https://issuetracker.google.com/issues/572741654
  8. まとめ - 課題 > 複雑化する検索‧⼀括取得を、従来のやり⽅(GETパラメータ等)で 安全かつ綺麗に扱うのが難しかった - 課題に対するアプローチ > HTTP

    QUERY メソッドの採⽤した検索APIの採⽤ > Kotlinの型を活かした検索モデルの設計 - 成果 > 検索条件の追加や変更に強く、安全に扱えるAPIを実装できた - 今後 > 今回構築した仕組みを社内の他サービス‧APIに横展開していきたい

More Decks by SansanTech

Other Decks in Technology