You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
背景 APIドキュメントを書くのが楽になるツールまとめ - Qiita iodocsで便利なREST APIドキュメントを作成する - Qiita これまでずっとREST APIドキュメントをwiki上で管理していて、重たいページ上で特殊記法使ったり、スタイルの調整に時間を取られるのが辛かった。そこで良さげなドキュメントツールを色々調べてたんだけど、最終的にapiary.ioが一番良さそうという結論になってきた。 このサービスの主な特徴。 markdown記法でAPIドキュメントを記述できる ドキュメントの生成と同時にAPIのモックサーバを用意してくれる サインアップから5分くらいあればドキュメント公開できる。ドキュメントのホスト先を気にしなくてもいい。 特にドキュメントと一緒にモックを作ってくれるのは他にはないポイントでかなり便利。 使ってみる サインアップはGithubアカウントで h
周回遅れ感が半端ないけどバージョニング関連で色々読んで・聞いて思ったことを書く。 APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight Kazuho's Weblog: 拡張可能なWeb APIの設計原則と、バージョン番号を使う理由について Rebuild: 35: You Don't Need API Version 2 (Kenn Ejima) rest - Best practices for API versioning? - Stack Overflow RESTfulなサービスのバージョンングから得られた知見 RESTとバージョニング 基本的にいわゆる狭義のRESTとAPIのバージョニングは何も関係ない。強いて言えば、HATEOASはバージョニングにも使えるよ、というのがREST信者の主張であるものの、それが正しい(というか実用的)かど
restify is a node.js module built specifically to enable you to build correct REST web services. It intentionally borrows heavily from express as that is more or less the de facto API for writing web applications on top of node.js. Why use restify and not express? I get asked this more than anything else, so I'll just get it out of the way up front. Express' use case is targeted at browser applica
The XINS Projectは9月28日(米国時間)、XINSの最新版となる「XINS 2.1」を公開した。XINSはJavaで開発されたHTTPベースのAPIを実装するためのツールキット。SOAPやXML-RPC, RESTがサポートされている。多くのXMLベース仕様フォーマットで構成されており、HTML、WSDL、クライアントサイドコード、サーバサイドコード、テストフォームなどを自動生成可能。プロダクトはThe BSD Licenseのもとで提供されている。 XINS 2.1ではSwingを使ったグラフィックユーザインタフェースが追加されたほか、SOAPリクエスト/レスポンスをwsdl2apiコマンドマッピングする機能の実装、ACLを使ったInclude/Excludeコールの実現、OpenDocumentフォーマットを使った仕様生成の改善、新しいツールとしてemma、glean、
Memotuneでは現在、Web APIを開発している。GDataに準拠しているので、Web APIの形式はRESTfulだ。ただ、RESTfulは最近の流行とは言え、問題がない訳ではない。 最大の問題はテスト環境だ。PUTやDELETEといったHTTPメソッドを手軽に試せない。IEやFirefoxは対応しているようだが、おそらく手軽には試せないだろう。 そこで専用のクライアントを使うのが良い。RESTfulに限らず、XMLを経由したMashup開発者は必須ではないだろうか。 今回紹介するフリーウェアはeXeve、RESTfulなWebアプリケーション開発ユーティリティだ。 eXeveを使うとWeb APIとやり取りするXMLが簡単に作成できる。構造チェックやDTDによる検証ができればよけいなミスも減るはずだ。 また、PUTやDELETEといったHTTPメソッドを使ってデータを授受する事も
Tim Bray からアナウンスがあったとおり、 APP の標準化作業がほぼ終了しました。 RFC 番号が付くのはしばらく先だと思いますが、 現状の仕様を実装してもう問題ありません。 最後の draft-17 ベースの仕様が RFC になります。今後の修正は editorial なものだけのはずです。 この先、Web API を設計する人は、まず APP が利用できないか検討しましょう。 APP を採用すれば自然と REST スタイルを採用することになります。 これまで悩みがちだった Web API の設計が、かなり楽になると思います。 Web API を設計する人は、オレオレXMLを設計する前に、Atom/APP をベースにしたらどうなるか、 を考えて見ましょう。きっと Atom/APP は良い選択肢になってくれるはずです。 日本では AtomPP で定着しつつあった Atom Publ
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く