Herokuが自ら実践しているAPIデザインガイドをGithubに公開した. “HTTP API Design Guide” このガイドは些細なデザイン上の議論を避けて,ビジネスロジックに集中すること目的としている.Heroku特有なものではなく,一般にも十分適用できる知見となっている. 最近は,モバイル向けにAPIをつくることも多いため,勉強もかねて抄訳した.なお内容は,HTTP+JSONのAPIについて基本的な知識があることが前提となっている. 適切なステータスコードを返す それぞれのレスポンスは適切なHTTPステータスコード返すこと.例えば,“成功"を示すステータスコードは以下に従う. 200: GETやDELETE,PATCHリクエストが成功し,同時に処理が完了した場合 201: POSTリクエストが成功し,同時に処理が完了した場合 202: POSTやDELETE,PATCHリク
Today we’re open sourcing the toolchain Heroku uses to design, document, and consume our HTTP APIs. We hope this shows how Heroku thinks about APIs and gives you new tools to create your own. This toolchain includes: An HTTP API design guide, describing how we structure both internal and public-facing APIs and document them using the JSON Schema standard. A tool for working with JSON schemas and u
<Pick Up> How Squarespace CEO pivoted to scale for millions 誰でもおしゃれなウェブサイトを作れてしまう「Squarespace」。WordpressやDrupalを競合に持つSquarespaceは、ファウンダーAnthony Casalena自らの、「もっと良いウェブサイトを作りたい」というニーズから2004年に始まった。 デザイン性やスタイリッシュさにこだわり、「事業にとって最重要である事項」と「自分ではできないこと」を満たす人材を迎え入れることで、長期ビジョンに立ってサービスを着々と育ててきた。 スキル単体よりも、信頼のほうがよっぽど重要であるというのがCEOの持論。信頼は、長期戦の基盤だから。スキル“だけ”を求めるのは、さっさとエグジットする事業に向けたものだと。 米国社会の黎明期の鉄道会社の有名なお話がある。当時、花形だ
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く