API定義は、フロントエンドチームとバックエンドチーム、そして社内外のAPIコンシューマーとプロデューサーにとってのコミュニケーションの要です。これらはAPI戦略の中心的な要素です。しかし、API定義の作成は、基盤となる仕様の詳細をすべて知る必要があるため、困難な場合があります。
RestletはRestlet Studioを提供しています。これはOpenAPI仕様、略してOAS（以前はSwagger仕様として知られていました）のビジュアルエディターであり、API契約の作成を容易にするだけでなく、クライアントSDKやサーバーのスケルトンコード生成を迅速に開始したり、他のAPI形式からOASへの変換を支援したりします。
Restletは、Linux Foundationの傘下でOASを標準化し、進化させている組織であるOpen API Initiativeの設立メンバーであることを誇りに思っています。
ビジュアル編集
テキストエディターやIDEでSwaggerのJSONやYAML定義を手書きで作成する代わりに、Restlet Studioはより視覚的でインタラクティブなエクスペリエンスを提供します。マウスやキーボードショートカットを使って、豊富なコンポーネントを操作し、エンドポイント、セクション、リソース、メソッド、データ型などを編集できます！OASの構文の詳細をすべて知る必要はありません。UIをナビゲートするだけです！
コード生成
契約ファーストの提唱者であれば、APIを設計し、サーバーのスケルトンでAPIを実装するバックエンドコードと、コンシューマーがAPIを呼び出すためのクライアントSDKの両方を迅速に開始できます。Java、Android、iOS、Node.JS、Angular.JSなどに対応したキットが見つかるでしょう。
API定義の変換
既存のOAS定義がある場合は、Restlet Studioに簡単にインポートできます。しかし、他のAPI形式もサポートしており、OAS定義を他の形式でエクスポートすることも可能です。Studioを使えば、異なる世界をつなぐ必要がある場合や、ある形式から別の形式に変換したい場合に、API定義トランスレーターを自由に利用できます。
以下のスクリーンキャストは、Restlet Studioとそのさまざまな機能の優れた概要を提供します。もちろん、オンラインドキュメントもご覧いただけます。
Swagger仕様のビジュアルエクスペリエンスを開始する準備はできましたか？
