REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita

背景 APIドキュメントを書くのが楽になるツールまとめ - Qiita iodocsで便利なREST APIドキュメントを作成する - Qiita これまでずっとREST APIドキュメントをwiki上で管理していて、重たいページ上で特殊記法使ったり、スタイルの調整に時間を取られるのが辛かった。そこで良さげなドキュメントツールを色々調べてたんだけど、最終的にapiary.ioが一番良さそうという結論になってきた。 このサービスの主な特徴。 markdown記法でAPIドキュメントを記述できる ドキュメントの生成と同時にAPIのモックサーバを用意してくれる サインアップから5分くらいあればドキュメント公開できる。ドキュメントのホスト先を気にしなくてもいい。 特にドキュメントと一緒にモックを作ってくれるのは他にはないポイントでかなり便利。 使ってみる サインアップはGithubアカウントで h

[naqtn]

API Blueprint(https://apiblueprint.org/) の形式で書いた API を扱うサービス（って重要なことが何で書いてないんだろう...）

[ka-ka_xyz]

個人的には http://swagger.io/ 一択な気が。特にJavaだとJAX-RSとの相性が良いし（ソースとは別にmd形式でドキュメント書くとかマゾい事やってらんない）

[takaken1123]

[2016-12-06 10:19]

[ko-ya-ma]

Markdownで、モックサーバまで作ってくれる。とはいえ、ドキュメントとソースコードを別に管理しないとならなくなる

[kanno_kanno]

良さそう

[Dai_Kamijo]

REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない by @horimislime on @Qiita — 上條　大 (@Dai_Kamijo) September 9, 2015 from Twitter https://twitter.com/Dai_Kamijo September 09, 2015 at 02:01PM via IFTTT

[himaratsu]

最高っぽい

[ruicc]

markdown...

[igrep]

うーん、気になってるけどなかなか使う方向に踏み出せない。

[teracy_junk]

markdown記法・APIモックサーバも生成。便利そう

[Jxck]

markdown ライクにドキュメントが書けて、書いた結果からモックまで生成されるサービス。良さそう。

[kana321]

REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない

[sionsou]

おーこれよさそうね！

[hoisjp]

Swaggerが好みですが、いろいろ統合されてる感は確かに。

[abe_hn]

おお

[kasumani]

REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない これまでずっとREST APIドキュメントをwiki上で管理していて、重たいページ上で特殊記法使ったり、スタイルの調整に時間を取られるのが辛かった。そこで良さげ

[hatajoe]

これは便利、、MarkdownでRESTfulなモックサーバーだと、、。

[oki448jp]

REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない

[akikan2]

ドキュメント