OpenAPI Specificationを導入するまでの苦労と失敗、その後の効果 - RAKUS Developers Blog | ラクス エンジニアブログ

2024/08/26 15 users ラクス 苦労 RAKUS Developers Blog

はじめに 対象読者 TL;DR OpenAPI Specificationとは OASを導入することの何が嬉しい？ 1. プロダクトごとにAPI仕様書を記述するツールやフォーマットがバラバラでスイッチングコストがかかる 2. 記述量が増えると動作が重くなる 3. API仕様変更の伝達漏れの多発 導入までの課題 1. OASの調査に時間をかけすぎた 2. OAS... 続きを読む

OpenAPI Specification v3.0.3のコーディング規約を公開しました | フューチャー技術ブログ

2024/07/02 8 users コーディング規約 フューチャー技術ブログ OAS https

はじめにフューチャーの有志メンバでOpenAPI Specification（OAS） v3.0.3に対応したコーディング規約を作成しました。 https://future-architect.github.io/coding-standards/documents/forOpenAPISpecification/OpenAPI_Specification_3.0.3.html 2023年7月にv2.0の規約を公開してから約1年ぶりのアップデートとなりま... 続きを読む

OpenAPI Specification ドリブンな開発事例とそれを支えるツール - NTT Communications Engineers' Blog

2021/12/03 9 users ツール Blog 開発事例

これは NTT Communications Advent Calendar 2021 3日目の記事です。 こんにちは、イノベーションセンターの松田 (@take4mats) です。 当社の Smart Data Platform (SDPF) のサービスラインナップの多くは、お客さまがサービスご利用に必要な操作を統一的に行うための Web UI に加え、同等の Web API を提供しています。... 続きを読む