2015-08-06から1日間の記事一覧

APIは一度作ったら終わりだと思っていませんか?

APIはシステム間連携、特に自動化に用いられることが多いため、一旦仕様が決まるとなかなか変更が難しいものです。そのためついつい触らぬ神のたたりなしとばかりにAPIの利用する側でどうにかしようと考えてしまいがちです。 しかし海外の各サービスで提供さ…

分かりやすいドキュメントを。APIドキュメントジェネレータまとめ(2)

前半はこちら。 rjha/restdoc PHP製のスクリプトでYAMLフォーマットの定義からドキュメントを生成します。スクリプト言語なのでYAMLを更新するだけでいつでも最新のドキュメントが読めるのは良さそうです。 MireDot | REST API Documentation Generator for …

分かりやすいドキュメントを。APIドキュメントジェネレータまとめ

APIはシステム用の機能になります。分かりやすいビジュアル化された画面がある訳ではありませんので、使い方のドキュメントが必須です。 今回はAPIドキュメントを生成するためのライブラリを紹介します。 Swagger | The World's Most Popular Framework for …

© NTT Communications Corporation All Rights Reserved.