タグ

ブックマーク / ksky.hatenadiary.org (2)

  • らくらくシーケンス図:WebSequenceDiagrams #apijp - Groovyラボ

    これはWeb API Advent Calendar 2014、7日目のエントリです。知っている方も多いと思いますが、ツールの小ネタで。 Web APIを扱っていると、認証やマッシュアップのフローの記述など、簡単なシーケンス図を書きたくなる場合がよくあります。こんなときにオススメなのが、カナダのHanov Solutions社が提供する便利なWebサービスWebSequenceDiagrams。 次のようなシンプルなテキストを書くだけで: title GWでのmashup アプリ->GW: POST 郵便番号 GW->サービスA: GET /郵便番号 サービスA->GW: 住所(JSON) GW->サービスB: POST 住所 サービスB->GW: 緯度経度(XML) GW->アプリ: 緯度経度(JSON)次のようなイメージを生成してくれます: 基的に無償で使えますし、生成した図は直接リ

    らくらくシーケンス図:WebSequenceDiagrams #apijp - Groovyラボ
  • REST APIを記述せよ!Swagger紹介 #apijp - Groovyラボ

    Web API Advent Calendar 2014、初日はSwaggerを紹介します。 SwaggerはReverbによって開発された、RestfulなAPIを記述する標準仕様です。APIを機械可読な形で記述することは、ドキュメント生成やツール開発、さまざまな形での自動化に非常に重要です。好き嫌いはともかく、SOAPにはWSDLという統一標準がありましたが、RESTには質的にそういった標準がないため、類似するさまざまな仕様が開発されてきました。Swaggerはその中でも最も有望なものの一つだと思います。 1. 特徴 記述はJSONでシンプル。ミニマム定義の例: { "swagger": "2.0", "info": { "version": "1.0.0", "title": "petstore" }, "paths": { "/users": { "get": { "respon

    REST APIを記述せよ!Swagger紹介 #apijp - Groovyラボ
  • 1