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

Type Spec と Go（gin） で作るTypeSafeな web api/Craete...

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest. →
Avatar for Ryusei Ohkura Ryusei Ohkura
November 08, 2025
0
360

Type Spec と Go（gin） で作るTypeSafeな web api/Craete type safe web api with typespec and go

ゆる勉強会 in 新宿御苑 #2
で発表させていただいた資料です！

https://engineers-anime.connpass.com/event/374534/

Avatar for Ryusei Ohkura

Ryusei Ohkura

November 08, 2025
Tweet

More Decks by Ryusei Ohkura

See All by Ryusei Ohkura
登壇を続けていたら地域コミュニティを作るようになった話/outputconf2026
Avatar for Ryusei Ohkura 3l4l5
0
0
本当にpythonは堅牢さに欠けるのか
Avatar for Ryusei Ohkura 3l4l5
0
180
習慣化するための技術 / Techniques for Habit Formation
Avatar for Ryusei Ohkura 3l4l5
3
420
SQLAlchemy の select(User).where(User.id =="123") を理解してみる/sqlalchemy deep dive
Avatar for Ryusei Ohkura 3l4l5
3
1k
NEW GAMEが良いということを伝えたいLT / New Game is iizo.
Avatar for Ryusei Ohkura 3l4l5
0
80
「アニメから学ぶ」から学ぶ具体と抽象/ I wanna learn abstraction from "learning from anime"
Avatar for Ryusei Ohkura 3l4l5
4
990
アニメからリーダーシップを学びたい / i wanna learn leader ship from animation
Avatar for Ryusei Ohkura 3l4l5
1
120
ドミネーターの実装で学ぶSOLID原則/learn solid law with dominator
Avatar for Ryusei Ohkura 3l4l5
2
150
学園アイドルマスターでコミュニケーションを学ぼう！/learn communication with gakuen idol master
Avatar for Ryusei Ohkura 3l4l5
1
290

Featured

See All Featured
30 Presentation Tips
Avatar for Ian Lurie portentint
PRO
1
260
Docker and Python
Avatar for Tania Allard trallard
47
3.8k
Visualization
Avatar for Eitan Lees eitanlees
150
17k
10 Git Anti Patterns You Should be Aware of
Avatar for Lemi Orhan Ergin lemiorhan
PRO
659
61k
The SEO identity crisis: Don't let AI make you average
Avatar for Varn varn
0
430
Crafting Experiences
Avatar for Bethany Jepchumba bethany
1
97
Navigating the Design Leadership Dip - Product Design Week Design Leaders+ Conference 2024
Avatar for Andy Polaine apolaine
0
250
Visual Storytelling: How to be a Superhuman Communicator
Avatar for David Neal reverentgeek
2
480
HU Berlin: Industrial-Strength Natural Language Processing with spaCy and Prodigy
Avatar for Ines Montani inesmontani
PRO
0
300
Design in an AI World
Avatar for tapps tapps
0
180
Jamie Indigo - Trashchat’s Guide to Black Boxes: Technical SEO Tactics for LLMs
Avatar for Tech SEO Connect techseoconnect
PRO
0
91
Introduction to Domain-Driven Design and Collaborative software design
Avatar for Kenny Baas-Schwegler baasie
1
690

Transcript

  1. Type Spec と Go（gin） で作るTypeSafeな web api ヲクラ @3l4I5


  2. 自己紹介
 3l4i5 3l4l5 - クロスマート株式会社
 - 請求書チーム
 - テックリード
 -

    バックエンドエンジニア
 - すき
 - 🎷響けユーフォニアム
 - 🤖SSSS.GRIDMAN
 - 🎸ぼっち・ざ・ろっく
 - 🐧宇宙よりも遠い場所
 往蔵隆成(ヲクラ)

  3. Web APIを作る時に考えること • リクエストのバリデーションを楽に書きたい • swagger.yaml書きたくないけど、swagger.yamlはほしい（わがまま） • バックエンドのcontroller層でも型safeに開発したい • （Go書けるようになりたいのでGoで書きたい）

  4. リクエストのバリデーション楽に書きたい やだ！！！！！

  5. Web APIを作る時に考えること • リクエストのバリデーションを楽に書きたい • swagger.yaml書きたくないけど、swagger.yamlはほしい（わがまま） • バックエンドのcontroller層でも型safeに開発したい • （Go書けるようになりたいのでGoで書きたい）

    FastAPI（Python） Nest.js（TypeScript/JavaScript) Micronaut(Kotlin) で、コードで型定義 → OpenAPI 仕様書生成可能

  6. コードで型＋バリデーション定義 OpenAPI 仕様書

  7. バックエンド バリデーション＋型のコード生成 OpenAPI 仕様書 何か

  8. バックエンド バリデーション＋型のコード生成 OpenAPI 仕様書 TypeSpec

  9. バックエンド バリデーション＋型のコード生成 OpenAPI Specification TypeSpec Swagger書かなくて良い！ ＋ バリデーション書かなくて良い！ ＋ Gin対応！

  10. TypeSpecとは？ • TypeScriptのような書き方で APIのinterfaceを定義できる • TypeSpecで定義された記述を OpenAPI 仕様書に変換できる

  11. TypeSpecとは？ “/stores”に対して • query paramでリクエストした場合は Storeのリストを返す • path paramでリクエストした場合は Store単体を返す

  12. TypeSpecとは？ “/stores”に対して • query paramでリクエストした場合は Storeのリストを返す • path paramでリクエストした場合は Store単体を返す

    入れ子のオブジェクトも 簡単に表現

  13. TypeSpecの記述 Oapi.ymlの記述 変換！

  14. TypeSpecの記述 Oapi.ymlの記述 変換！ 圧倒的に楽！🎉

  15. バックエンド バリデーション＋型のコード生成 OpenAPI 仕様書 TypeSpec 今の話

  16. OpenAPI 仕様書 TypeSpec 今度こっち バックエンド バリデーション＋型のコード生成

  17. • OpenAPI 仕様書からGoのコードを生成 できる • ginをはじめとした、様々な GoのWeb APIのcontroller層のコード を生成 OpenAPI

    Specificationからのコード生成

  18. 詳しくは割愛（ドキュメントを参照ください） • OpenAPI仕様書で定義した型を元に バリデーションコード レスポンスの型 を生成 • レスポンスには勝手にstatus codeをつけてくれる •

    errを返せば勝手に500 errorとして解釈してくれる → 至れり尽くせり！ oapi-codegen

  19. バックエンド バリデーション＋型のコード生成 OpenAPI 仕様書 TypeSpec TypeSpec　Cli oapi-codegen

  20. バックエンド バリデーション＋型のコード生成 OpenAPI 仕様書 TypeSpec TypeSpec　Cli oapi-codegen フロントエンド クライアント・型生成 orval

    / openapi-typescript

  21. バックエンド バリデーション＋型のコード生成 OpenAPI 仕様書 TypeSpec TypeSpec　Cli oapi-codegen フロントエンド クライアント・型生成 orval

    / openapi-typescript 一気通貫の Type safe な web 開発！💪

  22. 宣伝！ LT会やるよ〜　来てね〜