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
130
響け!ユーフォニアムと考える「決め方」/Thinking About Decision-Making with Sound! Euphonium
Avatar for Ryusei Ohkura 3l4l5
1
210
同人誌を作ろう（物理）/ let's make self made books
Avatar for Ryusei Ohkura 3l4l5
1
510
楽しそうなつよつよエンジニアと目が死んでる僕/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
630

Featured

See All Featured
The Limits of Empathy - UXLibs8
Avatar for Cassini Nazir cassininazir
2
730
Getting science done with accelerated Python computing platforms
Avatar for Jacob Tomlinson jacobtomlinson
2
540
Accessibility Awareness
Avatar for Sarah Abderemane sabderemane
1
250
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
Avatar for Michelle Schulp Hunt marktimemedia
31
2.9k
Distributed Sagas: A Protocol for Coordinating Microservices
Avatar for Caitie McCaffrey caitiem20
333
23k
[SF Ruby Conf 2025] Rails X
Avatar for Vladimir Dementyev palkan
3
1.5k
Into the Great Unknown - MozCon
Avatar for Noah Learner thekraken
41
2.8k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
Avatar for Morgane Peng morganepeng
133
20k
Scaling GitHub
Avatar for Zach Holman holman
464
140k
4 Signs Your Business is Dying
Avatar for Josh Pigford shpigford
187
23k
Building Flexible Design Systems
Avatar for Yesenia Perez-Cruz yeseniaperezcruz
330
41k
DBのスキルで生き残る技術 - AI時代におけるテーブル設計の勘所
Avatar for soudai sone soudai
PRO
68
58k

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