Hatena Blog Tags
はてなブログ トップ
OpenAPI
このタグでブログを書く
言葉の解説
ネットで話題
関連ブログ

OpenAPI

このタグの解説についてこの解説文は、すでに終了したサービス「はてなキーワード」内で有志のユーザーが作成・編集した内容に基づいています。その正確性や網羅性をはてなが保証するものではありません。問題のある記述を発見した場合には、お問い合わせフォームよりご連絡ください。
エムスリーテックブログ•15日前

AI プロダクトのマイクロサービス開発でスキーマ共有に困ったので CLI「skem」を作った

こんにちは、山本（@hiro_o918）です。 この記事はAI・機械学習チームブログリレー 2 日目の記事です。 1 日目は北川さんの「gokartに型を入れるためにspotifyやfacebookのOSSにコントリビュートした話」でした。 www.m3tech.blog はじめに AI チームでは、LLM を活用した AI プロダクトを開発しています。 こうしたプロダクトでは LLM の推論に時間がかかるため非同期処理が必須になったり、機能ごとに独立した API として切り出したりすることが多く、自然とサービスが分割されていきます。 サービスが分割されると、API の定義だけでなく PubS…

#OpenAPI#Protocol Buffers#OSS

関連ブログ

amahisa3のブログ•2ヶ月前

OrvalとOpenAPIスキーマを用いてフロントエンドのAPI層を自動生成する

はじめに Orvalとは 前提 セットアップ OpenAPIスキーマを用意 Orvalの設定ファイルを作成 生成コマンドを実行 生成結果を確認 型定義(api.schemas.ts) APIクライアント関数(api.ts) ユーザー一覧取得 ユーザー作成 コメント更新(PATCHメソッド) 運用フロー まとめ 参考リンク はじめに フロントエンド開発では、バックエンドとのやり取りは避けては通れない場面が多いです。 fetch処理を手書きしレスポンスの型定義を手動で管理していると、APIの変更に追従するのを忘れて未対応のままランタイムエラーが発生するという経験はないでしょうか？ 今回、OpenA…

#Orval#OpenAPI#TypeScript#フロントエンド#コード自動生成
asken テックブログ•4ヶ月前

AI生成のOASからコード自動生成、作業時間とトークン削減の試み

はじめに この記事は asken Advent Calender 2025 17日目の記事です。 こんにちはプロダクト開発部 法人事業担当の入江です。 先日OpenAPIの仕様書(以下、OAS)からコードを自動生成したので、その取り組みをご紹介します。 AIを活用した開発プロセス改善を考えていた際に、AIに書かせたOASをもとに後続の成果物を自動生成することで、AIのトークン消費を抑えつつプロセス改善できると考えたことがきっかけです。 OASのようなAPIの仕様書をもとにして開発を進めることを「スキーマ駆動開発」と呼びます。 これには多くの便利なツールが用意されていますが、これまでは「Open…

#OpenAPI Generator#OpenAPI#SpringBoot#アドベントカレンダー
TechDoctor開発者Blog•9ヶ月前

クライアントとサーバーで、APIの型・バリデーションルールを一元化する

こんにちは。株式会社 TechDoctor でソフトウェアエンジニアをしている大瀧です。突然ですが、アプリケーション開発で、クライアントとサーバーの API の型やバリデーションルールが食い違い、予期せぬバグに繋がった経験はないでしょうか。このような課題の解決策として、本記事では、OpenAPI スキーマをもとに、API の型とバリデーションルールを一元管理する方法を紹介します。ここで紹介するアプローチは、 OpenAPI スキーマを作成できる限り特定の言語やフレームワークに依存しませんが、今回は具体例として FastAPI、Pydantic、Zod、openapi-zod-client を使…

#OpenAPI#型定義#バリデーション#アプリケーション開発
きり丸の技術日記•10ヶ月前

FastAPIから型定義を出力する

始めに 小ネタ。 FastAPIからopenapi.jsonが出力できるなら、フロントエンドで使用する型定義まで出力する手順を確立したくて記事にします。 なお、フロントエンドはすでに構築されていたこともあり、自動生成した型定義の導入までは行えていません。また、FastAPIから型定義を出力する際にこういう工夫をしています、というコメント募集しています。 環境 FastAPI 0.115.12 openapi-typescript 7.8.0 @openapitools/openapi-generator-cli 2.20.2 実装 OpenAPIファイルの取得 FastAPIの/openapi…

#fastapi#OpenAPI#OpenAPI Generator#openapi-generator-cli
every Tech Blog•10ヶ月前

OpenAPI における null 値の表現の仕方

こんにちは、@きょーです！普段はデリッシュキッチン開発部のバックエンド中心で業務をしています。 はじめに OpenAPI で API 仕様書を書く際、null 値を許容するプロパティの表現方法はバージョンによって異なります。たとえば、ユーザープロフィールのメールアドレスのように「値が存在しない（null）」を許容したいケースはよくありますが、その書き方や推奨される方法は OpenAPI のバージョンごとに変化してきました。 この記事では、OpenAPI 3.0.0 と 3.1.0 それぞれでの null 許容プロパティの書き方や、その背景、なぜ仕様が変わったのか、どちらを使うべきかについて解説…

#APIDocumentation#OpenAPI#OpenAPI Generator
freee Developers Hub•10ヶ月前

OpenAPI ではなく TypeSpec を読み書きするスキーマ駆動開発

支出管理開発本部で事業部横断テックリードをしている @ogugu です。 広く複雑で大規模になりつつある支出管理のアーキテクチャについて、以下の連載形式でご紹介していきます。 (本記事) 支出管理におけるTypeSpecを中心にしたスキーマ駆動開発 ソフトウェアアーキテクチャに基づいた自動テスト戦略と実装ガイドライン 支出管理におけるマイクロサービスアーキテクチャの知見 今回は、TypeSpec を中心にしたスキーマ駆動開発をご紹介します。 結論からいうと、筆者は TypeSpec について「OpenAPI からの移行コストや技術的ロックインリスクを伴わず、開発体験を向上する最高のツール」と評…

#Typespec#OpenAPI#Go言語#react#開発生産性
スパイダープラス Tech Blog•10ヶ月前

hono/zod-openapiで実現するAPI開発実践

🧪 @hono/zod-openapi でAPI開発をネクストレベルに 前回投稿の記事、「TypeScriptとhonoで作るDI実践入門」ではHonoとTypescriptで型安全なDIを実践しました。 techblog.spiderplus.co.jp しかし、前回の実装では以下の課題がありました。 リクエスト/レスポンスの型安全性が不十分 APIドキュメントを手動で管理する必要がある バリデーションロジックが分散してしまう 今回はこの課題に対して、@hono/zod-openapiを導入し解決していきます。 @hono/zod-openapiを導入することで、ZodスキーマからOpenA…

#TypeScript#Zod#OpenAPI#API開発#Hono
弁護士ドットコム株式会社 Creators’ blog•10ヶ月前

TypeScript開発者が試すOrval活用術：OpenAPIからMCPサーバーを自動生成しClaudeでAPIを呼び出すまで

🐾 はじめに こんにちは、砂川(@misdo_tabeyo)です。 普段は『弁護士ドットコムLIBRARY』と『BUSINESS LAWYERS LIBRARY』というサービスでフロントエンド開発を担当しています。これらのサービスでは、Orval を利用して OpenAPI からAPIクライアントやZodのバリデーションスキーマを生成しています。 そんなOrvalに最近、Model Context Protocol (MCP) サーバーの生成機能が追加された と知り、早速試してみました。 MCP は LLM（大規模言語モデル）アプリケーションと外部ツール・データソースを接続するための標準プロト…

#TypeScript#Orval#MCP#Claude#OpenAPI