json-ld - 新しい API には、swagger ドキュメントまたは Hydra:ApiDocumentation を使用します。

Question

私は現在、API を公開するためのテクノロジー/フォーマットを選択中です。このトピックについては多くの議論があるようですが、将来使用するためのものを見つけることができませんでした. Hydraを使用する予定です:

http://www.markus-lanthaler.com/hydra

完全に休息しているように見えますが（ハイパーメディアAPI）、まだ受け入れられていないようです（HALもそうではありません）。

http://www.markus-lanthaler.com/hydra/api-demo/vocabに行くと、swagger が返すような json が表示されます。

私の質問: - Hydra Documentation は、swagger のような sthg を意図したものですか? swagger のようなツールを見つけることができます。- json-ld を使用して、操作に関する詳細な説明があるように見えるので、Hydra を使用したいと思いますが、Hal や swagger ほどサポートされていないようです。・ハイドラ経験のある方

Answer 1

Hydra の使用をご検討いただきありがとうございます。おっしゃるとおり、まだ大規模なツールはありませんが、それは時間の問題です。実際、私はすでにドキュメント ジェネレーターに取り組んでいます。Hydra に関してさらに質問がある場合は、遠慮なくメーリング リストに投稿してください。そのリストには、喜んで助けてくれる人がたくさんいます。