SwaggerでRESTful APIの管理を楽にする - Qiita
背景 最近は変化し続ける要件に対応するために、システムも柔軟であることが求められています。 そのため、部分的に変更やスケールの可能なシステムを構築し、API経由で連携するマイクロサービス的アーキテクチャが増えてきています。 そういった設計の中で問題になっていくのが、従来のモノリシックなアプリケーションではIDEやコンパイラなどで行っていた、機能間のインターフェイスをどう管理するかという部分です。 Swaggerとは? SwaggerとはRESTful APIのドキュメントや、サーバ、クライアントコード、エディタ、またそれらを扱うための仕様などを提供するフレームワークです。 公式サイトでは、The World's Most Popular Framework for APIsと謳っています。 その理由は、マイクロソフト、Google、IBM、SmartBearなどを大手の企業を含む「Open
How to Use Our REST APIs | Twilio
API is short for 'Application Programming Interface' . An API is a set of rules that lets programs talk to each other, exposing data and functionality across the Internet in a consistent format. REST stands for 'Representational State Transfer'. This is an architectural pattern that describes how distributed systems can expose a consistent interface. When people use the term 'REST API', they are g
RESTのベストプラクティス | POSTD
現在ではREST APIはとても一般的な話題です。ほとんどすべてのWebアプリケーションの一部分となっています。シンプルで一貫性があり実際的なインターフェースは必須です。これは皆さんのAPIを他の人が使うことをとても容易にします。皆さんにとってはRESTの実践が日常的に感じられるかもしれませんが、RESTをあまり尊重しない人々もよく見かけます。これがRESTについて投稿するきっかけでした。 この記事にはRESTfulなAPIを設計する時に考慮すべきベストプラクティスがあります。 注意 : ここでのベストプラクティスは、私が過去の経験に基づいて良いと考える事例です。もし違う考えをお持ちであれば、お気軽にメールをくだされば意見交換できると思います。 APIのバージョンを示す APIのバージョンは必須であるべきです。これがあると時間が経ってAPIが変わっても影響を受けません。その方法の1つはUR
書評「JavaによるRESTfulシステム構築」 - きしだのはてな
監訳者のartonさんより「JavaによるRESTfulシステム構築」を献本いただきました。直接献本いただいたのはオライリーさんからですけども。 これは「RESTful Java With JAX-RS」という本の翻訳なわけですけど、こちらのタイトルからわかるとおりJAX-RS(JSR-311)の解説本です。何で邦題からJAX-RS抜いちゃったんだろ？ ところでJAX-RSというのは、JavaでRESTなWebサービスを構築するためのAPIなのだけど、これがかなり素敵です。 たとえば、こんな感じの名前と住所を保持するクラスを用意します。 package rest; import javax.xml.bind.annotation.XmlRootElement; @XmlRootElement public class Customer { public String name;//名前 p
Scenic3 によるRESTサポート - やさしいデスマーチ
Scenic3はSlim3のController層を薄くラップした拡張ライブラリです。Slim3では1アクション（URL）に対して１つのControllerを作成するシンプルなデザインですが、どうしてもControllerの数が多くなってしまいます。関連するアクションは１つのクラスにまとめ、アクションメソッドを複数定義する設計を好む人にとってはやや窮屈な仕様です。Scenic3ではそんな人達のために、複数のControllerクラスを1つのPageクラスに定義する手段を提供しています。 一方、REST風のAPIを設計する場合は同一URLに対して異なるHTTPメソッドを割り当てる事になります。例えば、あるモデルに対する取得と削除は次のような同じURLとなります。 http://yourdomain/item/{id} idにはモデルを識別する一意の値が指定されます。同一のモデルに対する操作は
RESTでJSONなサービスをWCFで作ったり使ったりする - かずきのBlog@hatena
最近RESTが本格的に主流になりそうな感じですね。 SOAPでいい〜んだよSOAPでと思ってたら、以下のようなニュースとかも出てきたりして、ちょっと下火な感じがします。 ドアを閉じる WS-I - それが WS-* に意味するものは？ ということでトレンドを追いかけるということと、どうせなら得意なC#でやっちゃえ！ということで今回はWCFでRESTでJSONなサービスを作る＆使うことをやってみようと思います。下のような記事も出てるので、WCFでRESTやっておいて損はないでしょう。 将来のWCFは、RESTful ということで早速作っていきましょう。 プロジェクトの作成と実行方法の設定 まず、サービスを公開するためのWebアプリケーションを作成します。新規作成から「ASP.NET 空のWebアプリケーション」を作ります。余計なページとかは今回邪魔なのでシンプルに行きます。名前はRESTWc
Visual Studio 2008で標準搭載されたWindows Communication Foundation
サンプル2：RESTスタイルのWebサービス SOAPベースのWebサービスは、厳密なXML定義を扱う関係上、前項のサンプル作成を見ても分かるとおり、クライアント実装においてもそれなりの手順を踏む必要があります。Visual Studioを使って参照クラスを自動生成すれば手順は簡略化できますが、Ajaxなどで簡単にアクセスするには敷居が高いと言えます。開発者としても、ブラウザで簡単に内容を確認できないのは歯痒いところです。 こうした問題点を受け、近年のWebサービスの潮流は、SOAPベースのものから、データを抽象化せず、直接XMLを扱うRESTスタイルのサービスへと向かいつつあります。 では、.NET Framework 3.5でサポートされたWebプログラミングモデルを使い、RESTスタイルのWebサービスを作成してみましょう。 変更の流れ SOAPベースのWebサービスから、RESTス
[C#]10 行でズバリ !! REST サービスの作成 (C#)
WCF を使用した REST サービス (RESTful サービス) の作成方法がスバリのってます！！ 10 行でズバリ !! REST サービスの作成 (C#) http://msdn.microsoft.com/ja-jp/netframework/ee676509.aspx VBはこちら 10 行でズバリ !! REST サービスの作成 (VB) http://msdn.microsoft.com/ja-jp/netframework/ee676508.aspx もうちょっと深く潜りたい方は MSDNマガジンに記事があります RESTful クライアントの構築 http://msdn.microsoft.com/ja-jp/magazine/ee309509.aspx WCF を使用した RESTful サービスの概要 http://msdn.microsoft.com/ja-jp/
時代はRESTへ。SOAPの終わりを象徴する、Webサービス標準化団体のWS-Iが活動終了
SOAP、WSDL、UDDIなどを基盤とするWebサービスの標準化を行ってきた団体WS-I（Web Services Interoperability Organization）が、2002年からの約8年間の活動に幕を下ろしたことを正式に発表しました（参考：WS-I Completes Web Services Interoperability Standards Work（pdf））。 WS-Iは、WS-*と総称されるWebサービスのさまざまなプロトコル策定に取り組んできましたが、複雑すぎるといった評判がつきまとい、また策定そのものにも予想以上の時間がかかったことなどで、当初の想定ほど普及に至りませんでした。 そのSOAPに代わり、ここ数年サービス間をつなぐAPIとして存在感が高まっているのがREST（Representational State Transfer）と呼ばれるアーキテクチ
RESTが簡単に書けたのでRestControllerを書いてみた。 - TsutomuUchimaの日記
slim3のコントローラーは isGet(), isPost(), isPut(), isDelete() が用意されているのでRESTが簡単に書ける。便利だなぁ。なのでREST用のコントローラーを抽象化して RestController ってのを書いてみた。 ソースは以下の通り。 RestController.java package tutorial.cool.controller; import java.io.IOException; import java.io.OutputStreamWriter; import java.io.PrintWriter; import javax.servlet.http.HttpServletResponse; import org.slim3.controller.Controller; import org.slim3.controlle
「Java による RESTful システム構築」 が超勉強になる!! - 宇宙行きたい
JavaによるRESTfulシステム構築 作者: Bill Burke,arton,菅野良二出版社/メーカー: オライリージャパン発売日: 2010/08/23メディア: 大型本購入: 28人 クリック: 804回この商品を含むブログ (40件) を見る これ，本当にタイトル勿体無いなぁって思う本でした． いや，タイトルに偽りは無いんだけど，これだと REST に興味無い人は手に取らないだろうなぁと思って，それは凄く勿体無い内容なので，ホントみんな読むと良いと思う． 簡単に説明すると，Java で REST を扱うために JAX-RS という API があるんだけど( JSR311 )，そのエキスパートグループの一人であり，さらにその実装である RESTEasy の作者が書いている本です． で，この人は元々 SOAP とかのどちらかというと Fat な仕様大好きっこだったので，この本には色
RESTへどうぞ - winplusの日記
※オライリーから翻訳書『JavaによるRESTfulシステム構築』が出ましたので、そちらを参照してください。以下の記事はアテになりません。 以下『RESTful Java with JAX-RS』「Capter1:Introduction to REST」のメモ。目次はこちら WWWは生活に欠かすことのできない一部分になっている。 でも、Webがうまくいっているのはなぜ？これほど巨大に成長できたのは？これだけ急速に拡がったのは？ Roy Fielding がこれらの疑問に答える形で、アーキテクチャの原則を特定した。これが REpresentational State Transfar(REST)。RESTの原則は以下のとおり。 到達可能なリソース RESTでは、情報（データ）のキーはリソースであり、すべてのリソースはURIで到達可能でなければならない。 統一され制約されたインターフェイス
十兵衛のブログ: RESTをVC#2005で使う --YahooWEB検索の利用--
Yahooデベロッパーズネットワークが提供するWEB検索サービスをVS2005で作るデスクトップアプリケーションから利用してみようと考えました。YahooWEB検索を利用するには、YahooデベロッパーズネットワークにYahooIDの登録が必要です。YahooIDの登録後にアプリケーションIDを登録します。YahooWEB検索の利用についてはYahooデベロッパーズネットワークのサイトにある利用ガイドを良く読んでください。 YahooWEB検索では、.NETが推奨するXML WEBサービスではなく、REST（REpresentational State Transfer）形式のサービスとなっています。RESTもXML形式のデータです。スキーマ定義も準備されているので.NETアプリケーションで利用できないということではありません。.NET SDKに含まれるxsdユーティリティを使うと、XSD
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Create REST API using ASP.NET MVC that speaks both Json and plain Xml – Omar AL Zabir Blog
Browse code samples
Google Code Archive - Long-term storage for Google Code Project Hosting.
appengine-rest-server - Google Code