Stoplight Studio - Web APIの設計とドキュメントを管理するエディタ
Web APIを綺麗に設計するのはとても大変です。リソース名の決め方一つとってもそうですし、単純にCRUD操作だけで済まない場合のアクション名をどう指定するか、HTTPメソッドを何にするかといった問題もあります。 今回紹介するStoplight StudioはWeb APIのデザイン、ドキュメント整備を一括して行えるエディタです。
Stoplight Studioの使い方
まず組織、そしてプロジェクトを作成します。
リファレンスを作成します。ドメインを指定します。
APIキーベースの認証などを指定できます。
パスを設計します。
エクスポート機能があります。
ドキュメント。
OASベースのYAMLでも内容を編集できます。
プレビューもあります。
Stoplight Studioを使うことでWeb APIの設計が統一感を持ってスムーズに行えそうです。決めるべき、設計すべき項目も分かりますし、ドキュメントとの紐付けも容易です。RESTfulなWeb APIを設計する際にぜひ使ってみましょう。
Stoplight StudioはWeb/macOS/Windows/Linux用のソフトウェアです。
Stoplight Studio | OpenAPI Design, Planning & Modeling Tool stoplightio/studio: The modern editor for API Design and Technical Writing.