10 Best Practices for Better RESTful API | Thinking Mobile
Do not use verbs: /getAllCars /createNewCar /deleteAllRedCars 2. GET method and query parameters should not alter the state Use PUT, POST and DELETE methods instead of the GET method to alter the state. Do not use GET for state changes: GET /users/711?activate or GET /users/711/activate 3. Use plural nouns Do not mix up singular and plural nouns. Keep it simple and use only plural nouns for all r
HerokuのAPIデザイン
Herokuが自ら実践しているAPIデザインガイドをGithubに公開した． “HTTP API Design Guide” このガイドは些細なデザイン上の議論を避けて，ビジネスロジックに集中すること目的としている．Heroku特有なものではなく，一般にも十分適用できる知見となっている． 最近は，モバイル向けにAPIをつくることも多いため，勉強もかねて抄訳した．なお内容は，HTTP+JSONのAPIについて基本的な知識があることが前提となっている． 適切なステータスコードを返す それぞれのレスポンスは適切なHTTPステータスコード返すこと．例えば，“成功"を示すステータスコードは以下に従う． 200: GETやDELETE，PATCHリクエストが成功し，同時に処理が完了した場合 201: POSTリクエストが成功し，同時に処理が完了した場合 202: POSTやDELETE，PATCHリク
“RESTful Web APIs”の前半部を気合いを入れてまとめてみた
「RESTful Web APIs」を読んでいます。現在は第7章までを読み終わったところです。第7章の終わりに前半部の総まとめをするような箇所がありましたので、ここで自分なりに理解した内容をまとめておきます。 RESTful Web API「RESTful Web Service」の後継 「RESTful Web APIs」はその前書き(Preface)で触れられているように2007年に出版された「RESTful Web Service」の正式な後継にあたります。「RESTful Web Service」では、ウェブサービスのアーキテクチャについてSOAPなどに対する望ましいあり方としてRESTが提唱されました。結果として、RESTアーキテクチャは一般的に認められるようになりました。 ハイパーメディア 「RESTful Web APIs」は、「RESTful Web Servuce」後の状
emacs rst-mode のコマンドとかキーアサインとか - プログラマのネタ帳
とりあえずメモだけ key command desctiption C-c C-a rst-adjust 見出し作成。複数回実行で種類変更 C-c C-b rst-bullet-list-region 選択範囲のセクションごとにリスト化 C-c C-e rst-enumerate-region 選択範囲をセクションごとに連番リスト化 C-c C-v rst-convert-bullets-to-enumeration 選択範囲のリストを連番リストに変換 C-c C-d rst-line-block-region 選択範囲の行頭に縦棒を付ける C-c C-r rst-shift-region-right 選択範囲のインデント +2 C-c C-l rst-shift-region-left 選択範囲のインデント -2 rst-force-fill-paragraph 選択範囲のセクションを一
reStructuredText(reST)をEmacsで書く際のまとめ - YAMAGUCHI::weblog
はじめに こんにちは、非モテエンジニアです。長らくExcelで仕様書を書くのがブームらしいですが、Sphinxでドキュメントを書くと耳から脳漿垂れ流しになってしまうほど楽しくなってしまうというもっぱらの噂（俺の中で）なので、EmacsでreSTを書く際の便利機能をまとめてみました。 参照 404 Not Found 手前味噌ですが自分が関わっているSphinxの日本ユーザ会のサイトです。そもそもSphinxってなによ？Sphinx自体をどうやって導入したらいいのよ？って方はご参照ください。もちろん既にご存知の方にも最新情報含め有益な情報が満載です。 Emacs Support for reStructuredText rst.elの本家。英語ですがrst-modeについて一番詳しい説明がある場所だと思います。 rst.elの色設定 - DiaryException 色設定について詳しく説明
Overview — RestEditor-Plugin v1.0 documentation
Welcome ReST Editor is an Eclipse plug-in providing support to edit reStructuredText files. It was created by Thomas Calmant and is released under Eclipse Public License 1.0 (license text here). It was originally created as an internal project of isandlaTech to ease documentation writing. Previous versions descriptions are available on my blog, all new informations are on the SourceForge project p
Sphinx-Users.jp :: ドキュメンテーションツール スフィンクス Sphinx-users.jp
Sphinx-Users.jp¶ Sphinx-Users.jp(略称#sphinxjp)は、美しいドキュメントを簡単に生成することができるドキュメンテーションツール、 Sphinx （スフィンクス）の普及を主眼としたコミュニティです。SphinxはPythonの公式ドキュメントだけでなく、このSphinx-Users.jpのサイトも含め多くのマニュアルやサイトで使用されており、詳細を Sphinxの歴史で紹介しています。 Sphinx-Users.jp は日本の Sphinx コミュニティです。 Sphinx-Users.jp では、日本で散らばっているSphinx関連情報を集めて、Webサイト、イベントを通じてSphinx情報を発信します。 slack のコミュニケーションや勉強会の開催などを通じて、ドキュメントをパワーアップしたい人、ドキュメントや翻訳で苦労している人、Sphinxの
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
http://www.giantflyingsaucer.com/blog/?p=4673
Google Code Archive - Long-term storage for Google Code Project Hosting.