OpenAPI ではなく TypeSpec を読み書きするスキーマ駆動開発 - freee Developers Hub
支出管理開発本部で事業部横断テックリードをしている @ogugu です。 広く複雑で大規模になりつつある支出管理のアーキテクチャについて、以下の連載形式でご紹介していきます。 (本記事) 支出管理におけるTypeSpecを中心にしたスキーマ駆動開発 ソフトウェアアーキテクチャに基づいた自動テスト戦略と実装ガイドライン 支出管理におけるマイクロサービスアーキテクチャの知見 今回は、TypeSpec を中心にしたスキーマ駆動開発をご紹介します。 結論からいうと、筆者は TypeSpec について「OpenAPI からの移行コストや技術的ロックインリスクを伴わず、開発体験を向上する最高のツール」と評価しています。その理由を順にご紹介します。 TypeSpec とは OpenAPI とのスキーマの比較 導入の意思決定 TypeSpec を取り入れた開発フロー カスタム Linter / Decor
4万行超のopenapi.yamlをTypeSpecに移行した話
4 万行超の openapi.yaml のツラミ ファイルが大きすぎて編集しづらい OpenAPI が肥大化していくにつれて開発体験の低下を招いていました。 GitHub Copilot や Cursor の Tab 機能で随分楽になりましたが、それでも 4 万行もあるファイルを手作業で入力するのは純粋に辛いです。 AI Agent のコンテキストを大きく圧迫する Cursor 等の AI Agent のコンテキストを大きく圧迫することが直近の開発で大きな課題となりました。 具体的には次のような問題が発生したため、ファイルを分割することが急務となりました。 コンテキストが溢れて Cursor Agent が停止する Longer Context を有効化すると処理できるようになるが、トークンを余分に消費してしまう TypeSpec とは TypeSpec は、API を記述するための Mi
REST API 型安全を目指して 〜スキーマ駆動開発を支える技術〜 | su8ru
Previous slideNext slideToggle fullscreenOpen presenter view REST API 型安全を目指して 〜スキーマ駆動開発を支える技術〜 すばる / su8ru 2024-11-29 | 北大合同勉強会 2025 冬 https://slides.su8.run/241129-sdd 自己紹介 すばる / su8ru 北海道大学工学部 情報エレクトロニクス学科 2 年 HUIT / 3D 研 / JagaJaga (Hupass) Twitter: @su8ru_n <- New!! GitHub: @su8ru すきなもの：TypeScript / 初音ミク / 鏑木ろこ / ヰ世界情緒 お仕事でフロントエンドを、趣味でバックエンドを書いています 北大生による、北大生のための時間割アプリ サーバー実装のフルリプレース （および iNA
TypeSpec が OpenAPI や JSON Schema を書くのに良かったので紹介する
TypeSpec が OpenAPI や JSON Schema を書くのに良かったので紹介する 冗長になりがちで書くのが大変な OpenAPI や JSON Schema を型付きで体験よく記述できる TypeSpec を紹介します。 きっかけ SwitchBot の API を利用したくて OpenAPI のスキーマが提供されていないか調べていたんですが、SwitchBot の API ドキュメント は Markdown で記述されており、残念ながら OpenAPI から クライアントのコード生成等はできませんでした。 そこで、ドキュメントから OpenAPI のスキーマに起こしていこうかなと思ったんですが、OpenAPI Schema を一から書くのは割と大変なので、TypeSpec を使ってみたらかなり使い勝手が良かったので紹介します。 TypeSpec とは TypeSpec は
typespec.io
Introducing TypeSpec: A New Language for API-Centric Development Over last few years, we’ve been hard at work on https://typespec.io/, a modern API definition language. This language is designed to meet the evolving needs of API developers, architects, and managers in an environment where the delivery of consistently high-quality APIs and related experiences is becoming increasingly complex and cr
TypeScript のような構文で OpenAPI のスキーマを定義する TypeSpec
import "@typespec/http"; using TypeSpec.Http; model User { id: string; name: string; birthday?: utcDateTime; address: Address; } model Address { street: string; city: string; state: string; zip: string; } @route("/users") interface Users { list(@query limit: int32, @query skip: int32): User[]; create(@body user: User): User; get(@path id: string): User; } 上記のコードをコンパイルすると、以下のような OpenAPI のスキーマが出力されま
GitHub - microsoft/typespec
Official Docs | Try TypeSpec Online | Getting Started | Language Overview TypeSpec is a language for defining cloud service APIs and shapes. TypeSpec is a highly extensible language with primitives that can describe API shapes common among REST, OpenAPI, gRPC, and other protocols. TypeSpec is excellent for generating many different API description formats, client and service code, documentation, a
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - microsoft/typespec-mcp: Create an MCP Server for your API using the TypeSpec MCP Server
typespec.io