# OpenAPI

分類：API設計
公式：https://www.openapis.org/

## 既定として使う役割
- 外部公開API（§5）：REST＋OpenAPI（スキーマファースト）
  - 代替 GraphQL：クライアントが多様で取得項目の自由度が必要なとき
- APIドキュメント（§17）：OpenAPI＋Scalar

## ケース別の構成（§19）
- 自社SaaS（B2B）：API＝OpenAPI（oapi-codegen）→ openapi-typescriptでクライアント生成