安らかなwebServiceの記述方法

Question

私は2種類のWebサービスを知っています。

• SOAPのWebサービス
• 安らかなWebサービス

SOAPのWebサービスは、WSDLで記述することができます。 どのように記述するために安らかなwebserviceは、人々に電話する方法を知らせることができます。

私はドキュメントを扱っています。 WSDLのようなものはありますか？

Answer 1

悪いニュース：

あなたが記述しているとしてRESTを文書化する公式の方法はありません。また、WSDLを使用してコード成果物を生成し、サービスを文書化することにも注意してください。

良いニュース：

次の3つのオプションを見ることができますしかし：

1. WADL：標準としてコンテンダー：
2. RAML（広く使われているか、受け入れられていない）RESTのWSDL同等RESTを文書化し、WSDLに相当するコードを実装する方法。
3. スワッガー：RESTサービスを記録します。 WSDLに相当するものではありません。

醜いニュース：

いくつかのクライアントが闊歩して、いくつかのRAMLと快適になり何の「公式」の方法がありませんので、そのみんなに応えることは困難になるだろうがしかし、これはマイナーなポイントです。