Upgrade to Pro — share decks privately, control downloads, hide ads and more …
Sign up for free

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
570
0

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

More Decks by Ryusei Ohkura

See All by Ryusei Ohkura
ガールズ&パンツァーで学ぶ紅茶 / Learn About Tea with Girls und Panzer
Avatar for Ryusei Ohkura 3l4l5
0
75
響け!ユーフォニアムと考える「決め方」/Thinking About Decision-Making with Sound! Euphonium
Avatar for Ryusei Ohkura 3l4l5
1
200
同人誌を作ろう（物理）/ let's make self made books
Avatar for Ryusei Ohkura 3l4l5
1
500
楽しそうなつよつよエンジニアと目が死んでる僕/A brilliant engineer having a blast, and dead-eyed me.
Avatar for Ryusei Ohkura 3l4l5
2
300
予算10000円から始める自宅サーバー / start diy server with in 10000 yen
Avatar for Ryusei Ohkura 3l4l5
3
1k
コードギアスから学ぶ戦略と戦術/engineer-anime-2026-04-11
Avatar for Ryusei Ohkura 3l4l5
0
130
登壇を続けていたら地域コミュニティを作るようになった話/outputconf2026
Avatar for Ryusei Ohkura 3l4l5
2
2k
本当にpythonは堅牢さに欠けるのか
Avatar for Ryusei Ohkura 3l4l5
1
330
習慣化するための技術 / Techniques for Habit Formation
Avatar for Ryusei Ohkura 3l4l5
3
620

Featured

See All Featured
Why Your Marketing Sucks and What You Can Do About It - Sophie Logan
Avatar for Sophie Logan marketingsoph
0
420
Improving Core Web Vitals using Speculation Rules API
Avatar for Sergey Chernyshev sergeychernyshev
21
1.7k
A Modern Web Designer's Workflow
Avatar for Chris Coyier chriscoyier
699
190k
Ethics towards AI in product and experience design
Avatar for Skipper Chong Warson skipperchong
2
420
[RailsConf 2023] Rails as a piece of cake
Avatar for Vladimir Dementyev palkan
59
7.1k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
Avatar for Vitaly Friedman smashingmag
254
22k
Navigating Weather and Climate Data
Avatar for Ryan Abernathey rabernat
0
550
The innovator’s Mindset - 
Leading Through an Era of Exponential Change - McGill University 2025
Avatar for Jean-Marc De Jonghe jdejongh
PRO
1
370
Build your cross-platform service in a week with App Engine
Avatar for Jose L jlugia
234
19k
[SF Ruby Conf 2025] Rails X
Avatar for Vladimir Dementyev palkan
3
1.4k
[RailsConf 2023 Opening Keynote] The Magic of Rails
Avatar for Eileen M. Uchitelle eileencodes
31
10k
Making the Leap to Tech Lead
Avatar for Ryan Cromwell cromwellryan
135
10k

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会やるよ〜　来てね〜