api-guidelines/Guidelines.md at vNext · microsoft/api-guidelinesYou 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
Zalando RESTful API and Event Scheme Guidelines
Zalando’s software architecture centers around decoupled microservices that provide functionality via RESTful APIs with a JSON payload. Small engineering teams own, deploy and operate these microservices in their AWS (team) accounts. Our APIs express most purely what our systems do, and are therefore highly valuable business assets. Designing high-quality, long-lasting APIs has become even more cr
HTTP API ã®è¨è¨ˆæ–¹å‘
見ã¦ã¿ã‚‹ã¨ã€ãŸã—ã‹ã« Get 系㮠API ã ã¨ã—ã¦ã‚‚ POST を利用ã—ã¦ã„ã‚‹ã—ã€API ã® URL è¨è¨ˆã« get_shared_link_file ã®ã‚ˆã†ã«ã‚ˆã言ã‚れる REST ã£ã½ã„è¨è¨ˆã¯ä½¿ã£ã¦ã„ãªã‹ã£ãŸã€‚ ã“ã®æ–¹é‡ã¯åŒæ„ã 。自分ã¯çµæ§‹å‰ã« REST ã£ã½ã„ API ã‚’æ¨ã¦ã‚‹ã“ã¨ã«ã—ãŸã€‚ã ã‹ã‚‰ã¨ã„ã£ã¦ REST API ãŒãƒ€ãƒ¡ã ã¨ã‹ã¯æ€ã£ã¦ã„ãªã„。 一般ユーザãŒä½¿ã†å ´åˆã® API 㯠REST API ã§ã‚ã‚‹ã»ã†ãŒæ…£ã‚Œè¦ªã—ã‚“ã§ã„ã‚‹å ´åˆãŒå¤šã„ã‹ã‚‰ã 。 AWS ã§åˆ©ç”¨ã•ã‚Œã¦ã„ã‚‹ HTTP API 仕様AWS ã® DynamoDB ã® Erlang/OTP ドライãƒãƒ¼ã‚’書ã„ã¦ã„ã‚‹ã¨ãã«æ°—ã¥ã„ãŸã®ã ãŒã€AWS ã®ä¸€éƒ¨ã®ã‚µãƒ¼ãƒ“スã¯ã‹ãªã‚Šç‹¬ç‰¹ãª API ã®ä»•æ§˜ã«ãªã£ã¦ã„る。
WebAPIã§ã‚¨ãƒ©ãƒ¼ã‚’ã©ã†è¡¨ç¾ã™ã¹ã？15ã®ã‚µãƒ¼ãƒ“スを調査ã—ã¦ã¿ãŸ - Qiita
2017-01-05 追記 2016å¹´3月ã«ã‚¨ãƒ©ãƒ¼ã®æ¨™æº–å½¢å¼RFC7807「Problem Details for HTTP APIsã€ãŒæ案ã•ã‚Œã€ä»Šæ—¥ç¾åœ¨proposed standard(標準化ã¸ã®æå”±)ã¨ãªã£ã¦ã„ã¾ã™ã€‚ã“ã¡ã‚‰ã‚‚是éžã”覧ãã ã•ã„。 RFC 7807 - Problem Details for HTTP APIs HTTP APIã®è©³ç´°ãªã‚¨ãƒ©ãƒ¼æƒ…å ±ã‚’ãƒ¬ã‚¹ãƒãƒ³ã‚¹ã«æŒãŸã›ã‚‹ãŸã‚ã®ä»•æ§˜ 最近ã¯REST APIã‚’æä¾›ã—ã¦ã„るサービスãŒå¢—ãˆã¦ãã¦ã„ã¾ã™ãï¼ã¾ãŸå…¬é–‹ã•ã‚Œã‚‹APIã ã‘ã§ãªãã€Microservicesãªã‚¢ãƒ¼ã‚テクãƒãƒ£ã‚’採用ã—ã¦ã€ãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ãŒWeb APIã§é€šä¿¡ã™ã‚‹ã‚±ãƒ¼ã‚¹ã‚‚増ãˆã¦ãã¦ã„るよã†ã«æ€ã„ã¾ã™ã€‚ APIを使ã†ã¨ãã¯ã‚ã¾ã‚Šæ°—ã«ã—ãŸã“ã¨ã‚‚ãªã‹ã£ãŸã§ã™ãŒã€ã„ã–APIã‚’è¨è¨ˆã—ã¦ã¿ã‚‹ã¨ã©ã‚“ãªã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ã‚¤ã‚¹ãŒã„ã„ã®ã‹ã€ã©ã‚“ãªå½¢å¼ãŒã„ã„ã®ã‹ã¨ã„ã£ãŸç–‘å•ãŒæ¬¡ã€…ã¨å‡ºã¦ãã¾ã™ã€‚
技術/HTTP/RESTè¨è¨ˆæ€æƒ³ã® "Stateless" ã¨ã®ä»˜ãåˆã„æ–¹ - Glamenv-Septzen.net
id: 1350 所有者: msakamoto-sf 作æˆæ—¥: 2015-02-11 21:34:52 カテゴリ: HTTP プãƒã‚°ãƒ©ãƒŸãƒ³ã‚° [ Prev ] [ Next ] [ 技術 ] RESTfulãªAPIã‚„Webアプリケーションを開発ã™ã‚‹éš›ã«ã€ä¸€ã¤ã®ç–‘å•ãŒç”Ÿã˜ã‚‹ã€‚ RESTã§ã¯ã€Œã‚¹ãƒ†ãƒ¼ãƒˆãƒ¬ã‚¹ã€ã‚’é‡è¦–ã—ã¦ã€ã‚µãƒ¼ãƒã‚µã‚¤ãƒ‰ã§ã®ã‚»ãƒƒã‚·ãƒ§ãƒ³ç®¡ç†ã§ã¯ãªãã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆå´ã§èªè¨¼æƒ…å ±ã‚„çŠ¶æ…‹ã‚’ä¿æŒã—ã¦ã€ã‚µãƒ¼ãƒã«éƒ½åº¦é€ã‚‹æ–¹å¼ã‚’å”±ãˆã¦ã„る。ã“ã‚Œã¯HTTPã§å®Ÿè£…ã™ã‚‹ãªã‚‰ã€Cookieを使ã£ãŸã‚»ãƒƒã‚·ãƒ§ãƒ³ç®¡ç†ã§ã¯ãªãã€Basicã‚„Digestèªè¨¼ãªã©ã€HTTPèªè¨¼ã‚’使ã†ã“ã¨ã«ãªã‚‹ã€‚ ã—ã‹ã—ç¾å®Ÿå•é¡Œã¨ã—ã¦ã€ãƒ¢ãƒ€ãƒ³ãªWebサイトã§Basic/Digestèªè¨¼ã‚’扱ã†ã“ã¨ã¯ãªãã€ã‚µãƒ¼ãƒã‚µã‚¤ãƒ‰ã®Cookieを使ã£ãŸã‚»ãƒƒã‚·ãƒ§ãƒ³ç®¡ç†ã‚’使ã†ã“ã¨ã«ãªã‚‹ã€‚ RESTã«ãŠã„ã¦ã€ã‚¹ãƒ†ãƒ¼ãƒˆãƒ¬ã‚¹ã¨ã„ã†ç‰¹æ€§ã¨ã€ç¾å®Ÿã®ã‚»ãƒƒã‚·ãƒ§ãƒ³ç®¡ç†ã‚’ã©ã†
JSON Web Token ã®åŠ¹ç”¨ - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? Note: JWT ã®ä»•æ§˜ã‚„ãã‚‚ãã‚‚è«–ã®è©±ã¯è§¦ã‚Œã¾ã›ã‚“。ã©ã†ä½¿ã†ã‹ã€ä½•ãŒå‡ºæ¥ã‚‹ã‹ã—ã‹æ›¸ã„ã¦ã„ã¾ã›ã‚“。 JSON Web Token? JSON Web Token ã¨ã¯ã€ã–ã£ãã‚Šã„ã£ã¦ç½²åã®å‡ºæ¥ã‚‹ JSON ã‚’å«ã‚“ã URL Safe ãªãƒˆãƒ¼ã‚¯ãƒ³ã§ã™ã€‚ ç½²åã¨ã¯ã€ç½²å時ã«ä½¿ã£ãŸéµã‚’用ã„ã¦ã€JSON ãŒæ”¹ã–ã‚“ã•ã‚Œã¦ã„ãªã„ã‹ã‚’ãƒã‚§ãƒƒã‚¯å‡ºæ¥ã‚‹ã‚ˆã†ã«ã™ã‚‹ã“ã¨ã§ã™ã€‚ URL Safe ã¨ã¯ã€æ–‡å—通りã€URL ã«å«ã‚ã‚‹ã“ã¨ã®å‡ºæ¥ãªã„æ–‡å—ã‚’å«ã¾ãªã„ã“ã¨ã§ã™ã€‚ ã“ã‚Œã ã‘ã ã¨ã‚ˆãã‚ã‹ã‚Šã¾ã›ã‚“ãŒã€è§¦ã‚Šå¿ƒåœ°ã¨ã—ã¦ã¯æ¬¡ã®ã‚ˆã†ãªæ€§è³ªãŒã‚ã‚Šã¾ã™ã€‚ 発行者ã ã‘ãŒã€éµ
RESTã®ãƒ™ã‚¹ãƒˆãƒ—ラクティス | POSTD
ç¾åœ¨ã§ã¯REST APIã¯ã¨ã¦ã‚‚一般的ãªè©±é¡Œã§ã™ã€‚ã»ã¨ã‚“ã©ã™ã¹ã¦ã®Webアプリケーションã®ä¸€éƒ¨åˆ†ã¨ãªã£ã¦ã„ã¾ã™ã€‚シンプルã§ä¸€è²«æ€§ãŒã‚り実際的ãªã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã¯å¿…é ˆã§ã™ã€‚ã“ã‚Œã¯çš†ã•ã‚“ã®APIã‚’ä»–ã®äººãŒä½¿ã†ã“ã¨ã‚’ã¨ã¦ã‚‚容易ã«ã—ã¾ã™ã€‚皆ã•ã‚“ã«ã¨ã£ã¦ã¯RESTã®å®Ÿè·µãŒæ—¥å¸¸çš„ã«æ„Ÿã˜ã‚‰ã‚Œã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“ãŒã€RESTã‚’ã‚ã¾ã‚Šå°Šé‡ã—ãªã„人々もよã見ã‹ã‘ã¾ã™ã€‚ã“ã‚ŒãŒRESTã«ã¤ã„ã¦æŠ•ç¨¿ã™ã‚‹ãã£ã‹ã‘ã§ã—ãŸã€‚ ã“ã®è¨˜äº‹ã«ã¯RESTfulãªAPIã‚’è¨è¨ˆã™ã‚‹æ™‚ã«è€ƒæ…®ã™ã¹ãベストプラクティスãŒã‚ã‚Šã¾ã™ã€‚ æ³¨æ„ : ã“ã“ã§ã®ãƒ™ã‚¹ãƒˆãƒ—ラクティスã¯ã€ç§ãŒéŽåŽ»ã®çµŒé¨“ã«åŸºã¥ã„ã¦è‰¯ã„ã¨è€ƒãˆã‚‹äº‹ä¾‹ã§ã™ã€‚ã‚‚ã—é•ã†è€ƒãˆã‚’ãŠæŒã¡ã§ã‚ã‚Œã°ã€ãŠæ°—軽ã«ãƒ¡ãƒ¼ãƒ«ã‚’ãã ã•ã‚Œã°æ„見交æ›ã§ãã‚‹ã¨æ€ã„ã¾ã™ã€‚ APIã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’示㙠APIã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯å¿…é ˆã§ã‚ã‚‹ã¹ãã§ã™ã€‚ã“ã‚ŒãŒã‚ã‚‹ã¨æ™‚é–“ãŒçµŒã£ã¦APIãŒå¤‰ã‚ã£ã¦ã‚‚影響をå—ã‘ã¾ã›ã‚“。ãã®æ–¹æ³•ã®1ã¤ã¯UR
RESTful Web API 開発をã•ã•ãˆã‚‹ Garage - クックパッド開発者ブãƒã‚°
技術部ã®å°é‡Ž(@taiki45)ã§ã™ã€‚ã“ã®è¨˜äº‹ã§ã¯ç°¡å˜ãªã‚¢ãƒ—リケーション(ブãƒã‚°ã‚·ã‚¹ãƒ†ãƒ )ã®å®Ÿè£…を通ã—ã¦ã€ã‚¯ãƒƒã‚¯ãƒ‘ッドã§ä½œæˆãƒ»ä½¿ç”¨ã—ã¦ã„るライブラリã®Garage ã®ç´¹ä»‹ã¨ Garage を使ã£ãŸ RESTful Web API ã®é–‹ç™ºã‚’ã”紹介ã—ãŸã„ã¨æ€ã„ã¾ã™ã€‚ Garage 㯠RESTful Web API を開発ã™ã‚‹ãŸã‚ã®ã€ Rails gemified plugins ã§ã™ã€‚Rails プãƒã‚°ãƒ©ãƒžã¯ Garage を使ã£ã¦ Rails ã‚’æ‹¡å¼µã™ã‚‹ã“ã¨ã§ç´ æ—©ã Web API を開発ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚Garage ã¯æ–°ã—ãアプリケーションを開発ã™ã‚‹å ´åˆã«ã‚‚ã€æ—¢å˜ã® Rails アプリケーションã«çµ„ã¿è¾¼ã‚“㧠Web API を実装ã™ã‚‹å ´åˆã§ã‚‚使用ã§ãã¾ã™ã€‚Garage ã¯ãƒªã‚½ãƒ¼ã‚¹ã®ã‚·ãƒªã‚¢ãƒ©ã‚¤ã‚ºã‚„アクセスコントãƒãƒ¼ãƒ«ãªã© Web API ã®å®Ÿè£…ã«å¿…è¦ãªæ©Ÿèƒ½ã‚’ã‚«ãƒãƒ¼ã—ã¦ã„ã¾ã™ã€‚ Ruby
RailsãŒæ™‚代ã«åˆã‚ãªããªã£ã¦ã㟠- Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 追記 Railsã§JSè¾›ã„å•é¡Œã«é–¢ã—ã¦ã®çµè«–：http://qiita.com/kaiinui@github/items/dad6180f1910c6a4bfd5 -- è¿‘å¹´ã€(1) Web/App両対応ãŒå¢—ãˆã¦ããŸã“ã¨ã€(2) Webã§ã‚‚JSを多用ã™ã‚‹ã‚ˆã†ã«ãªã£ãŸã“ã¨ã€ã®äºŒã¤ãŒã‚ã‚Šã€ä»¥ä¸‹ã®ç‚¹ã§RailsãŒå¾®å¦™ã«ãªã£ã¦ã„る。 Viewã®JavascriptãŒRailsã‹ã‚‰ç‹¬ç«‹ã—ã¦ã„ã‚‹ API層ã®ã‚µãƒãƒ¼ãƒˆãŒå¾®å¦™ 最åˆã«æ›¸ã„ã¦ãŠãã¾ã™ãŒã€ç‰¹ã«æ±ºå®šçš„ãªè§£æ±ºç–ã‚‚ãªãã€è¾›ã„ã‹ã‚‰ä»Šå¾Œè§£æ¶ˆã•ã‚Œã¦ã»ã—ã„よãã€ãªè©±ã§ã™ã€‚ Viewã®JavascriptãŒ
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リク
[ãã®ï¼‘] Netflix: APIã®æ”¹å–„ã¨ç¶™ç¶šçš„デリãƒãƒªãƒ¼ - ワザノム| wazanova
http://techblog.netflix.com/2012/07/embracing-differences-inside-netflix.html 北米ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒãƒƒãƒˆãƒˆãƒ©ãƒ•ã‚£ãƒƒã‚¯ã®30%以上をå ã‚ã‚‹Netflixã®ã‚·ã‚¹ãƒ†ãƒ 構æˆã¯ã€UI（デスクトップã€ã‚¹ãƒžãƒ›ã€ã‚¿ãƒ–レットã€ã‚²ãƒ¼ãƒ コンソールã€TVã€ãƒ–ルーレイå†ç”Ÿæ©Ÿï¼‰ã¨ã‚µãƒ¼ãƒ“ス（Video meta data, search, user, A/B test, personalization）をAPIã§ã¤ãªãアーã‚テクãƒãƒ£ãƒ¼ã«ãªã£ã¦ã„ã¦ã€UIã¨ã‚µãƒ¼ãƒ“スãŒãã‚Œãžã‚Œç‹¬ç«‹ã—ã¦æ—©ã„スピードã§æ”¹å–„ & 新機能を投入ã§ãã‚‹ã‹ãŸã¡ã«ãªã£ã¦ã„ã¾ã™ã€‚ãã®API改善ã‹ã‚‰ç¶™ç¶šçš„デリãƒãƒªãƒ¼ã®ä»•çµ„ã¿ã‚’ã¤ãã‚Šã‚ã’ã‚‹ã¾ã§ã®æ˜¨å¹´ã‹ã‚‰ã®ä¸€é€£ã®å‹•ãã‚’ã€ï¼”回ã«ã‚ã‘ã¦ç´¹ä»‹ã—ã¾ã™ã€‚ã¾ãšæœ€åˆã¯APIã®æ”¹å–„ã®å–組ã¿ã‹ã‚‰ã€‚ 1) 背景 Web APIã¨ã—ã¦ã¯RESTãŒæ¨™æº–çš„ã«ãªã£ã¦ã„ã‚‹
Netflixã®APIプラットフォーム- ワザノム| wazanova
http://techblog.netflix.com/2014/03/the-netflix-dynamic-scripting-platform.html 1 comment | 0 points | by WazanovaNews â– comment by Jshiike | ç´„8æ™‚é–“å‰ Netflixã¯ã‚¹ãƒˆãƒªãƒ¼ãƒŸãƒ³ãƒ³ã‚°ã‚’é…ä¿¡ã™ã‚‹ãƒ‡ãƒã‚¤ã‚¹ãŒ800種ã«åŠã¶ãŸã‚ã€å„デãƒã‚¤ã‚¹ã‚’担当ã™ã‚‹ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆãƒãƒ¼ãƒ ã®ãŸã‚ã«ç¤¾å†…å‘ã‘APIを用æ„ã—ã¦ã„ã¾ã™ã€‚パブリックAPIã®ã‚ˆã†ã«å…¨å“¡ä¸€å¾‹ã®ä»•æ§˜ã‚’å¼·è¦ã™ã‚‹ã‹ãŸã¡ã§ã¯ã€ãƒ‡ãƒã‚¤ã‚¹ã”ã¨ã®æœ€é©åŒ–ãŒå›³ã‚Œãªã„ãŸã‚ã€å„クライアントãƒãƒ¼ãƒ ãŒã‚¨ãƒ³ãƒ‰ãƒã‚¤ãƒ³ãƒˆã‚’カスタマイズã§ãã‚‹ã‹ãŸã¡ã«ãªã£ã¦ã„ã¾ã™ã€‚ã“ã¡ã‚‰ã®å›³ã®ã‚ˆã†ã«ã€ã‚µãƒ¼ãƒå´ã«ã‚るクライアントアダプタã®ã‚³ãƒ¼ãƒ‰ã‚’クライアントãƒãƒ¼ãƒ ãŒæ‰±ã„ã¾ã™ã€‚ 今回ã¯åŒç¤¾ã®APIãƒãƒ¼ãƒ ãŒã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆãƒãƒ¼ãƒ ã®ãŸã‚ã«ç”¨æ„ã—ãŸé–‹ç™ºç’°å¢ƒã«ã¤ã„ã¦ã€è©³
Ruby Roguesメンãƒã¨iOSエンジニアã®APIè°è«– - ワザノム| wazanova
http://rubyrogues.com/147-rr-apis-that-dont-suck-with-michele-titolo/ 1 comment | 0 points | by WazanovaNews â– comment by Jshiike | ç´„4æ™‚é–“å‰ iOSエンジニアã®Michele Titoloã¯ã€Objective-Cã®ãƒ‡ã‚£ãƒšãƒ³ãƒ‡ãƒ³ã‚·ãƒ¼ã‚’管ç†ã™ã‚‹CocoaPodsã®ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã§çŸ¥ã‚‰ã‚Œã¦ã¾ã™ãŒã€ãƒ¢ãƒã‚¤ãƒ«ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã®ç«‹å ´ã‹ã‚‰APIを利用ã—ã¦é–‹ç™ºã™ã‚‹ãƒã‚¤ãƒ³ãƒˆã«ã¤ã„ã¦ã‚‚ã€è‡ªã‚‰ã®ãƒ–ãƒã‚°ã§ã¾ã¨ã‚ã¦ã„ã¾ã™ã€‚ 1) Follow Conventions ã¯ã˜ã‚ã¦ã®ã“ã¨ã«ãƒˆãƒ©ã‚¤ã™ã‚‹ã¨ãã¯å…ˆé§†è€…ã®çŸ¥æµã«å¾“ã†ã»ã†ãŒã€ã‚¯ã‚ªãƒªãƒ†ã‚£ã®é«˜ã„ã‚‚ã®ã‚’ã¤ãれるã®ã§ã€conventionã«å¾“ã†ã®ãŒã‚ˆã„。ãã®ã»ã†ãŒãƒ‡ãƒãƒƒã‚°ã‚‚ã—ã‚„ã™ã„。自分ã§APIã®ãƒ«ãƒ¼ãƒ«ã‚’定義ã™ã‚‹å¿…è¦ãŒç”Ÿã˜ãŸå ´åˆã¯ã€ä¸€è²«æ€§ã‚’ç¶æŒã—
You don't need API version 2 - yohei's diary
周回é…れ感ãŒåŠç«¯ãªã„ã‘ã©ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°é–¢é€£ã§è‰²ã€…èªã‚“ã§ãƒ»èžã„ã¦æ€ã£ãŸã“ã¨ã‚’書ã。 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信者ã®ä¸»å¼µã§ã‚ã‚‹ã‚‚ã®ã®ã€ãã‚ŒãŒæ£ã—ã„（ã¨ã„ã†ã‹å®Ÿç”¨çš„）ã‹ã©
æ‹¡å¼µå¯èƒ½ãªWeb APIã®è¨è¨ˆåŽŸå‰‡ã¨ã€ãƒãƒ¼ã‚¸ãƒ§ãƒ³ç•ªå·ã‚’使ã†ç†ç”±ã«ã¤ã„ã¦
APIã®ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã¯é™å±€åˆ†å²ã§ã‚„ã‚‹ã®ãŒè‰¯ã„ - Hidden in Plain Sightã«ã¯ãƒ–コメã—ãŸã®ã§ã™ãŒã€Rebuild: 35: You Don't Need API Version 2 (Kenn Ejima)ã§ã‚‚本件ã«è¨€åŠãŒã‚ã£ãŸã‚ˆã†ãªã®ã§ã€å°‘ã—一般論を書ã„ã¦ãŠããŸã„ã¨æ€ã„ã¾ã™ã€‚ â– Web APIã®è¨è¨ˆåŽŸå‰‡ã«ã¤ã„㦠ãã‚‚ãã‚‚ã€è‰¯ã„APIã¨ã¯ã©ã®ã‚ˆã†ãªç‰¹æ€§ã‚’ã‚‚ã¤ã‚‚ã®ã§ã—ょã†ã‹ï¼Ÿã€€ä¸€èˆ¬çš„ã«ã€ä»¥ä¸‹ã®ï¼’点ãŒæŒ™ã’られるã¨æ€ã„ã¾ã™ã€‚ æ‹¡å¼µãŒå®¹æ˜“ã§ã‚ã‚‹ 拡張時ã«å¾Œæ–¹äº’æ›æ€§ã‚’ç ´å£Šã—ãªã„ ウェブã®å ´åˆã¯ã€ã“ã‚Œã«åŠ ãˆã€ スケーラブルã§ã‚ã‚‹ HTTPã«èµ·å› ã™ã‚‹å•é¡Œã«ä¸Šæ‰‹ã«å¯¾å‡¦ã§ãã‚‹ ã“ã¨ãŒæ±‚ã‚られã¾ã™ã€‚ å‰ï¼’者ã¯ã‚¦ã‚§ãƒ–ã«é™ã‚‰ãªã„è¦ä»¶ã§ã™ã€‚ã“れを満ãŸã™è¨è¨ˆæ‰‹æ³•ã¨ã—ã¦ã¯ã€ リクエストãŠã‚ˆã³ãƒ¬ã‚¹ãƒãƒ³ã‚¹ã®ãƒ‘ラメータを拡張å¯èƒ½ã« 互æ›æ€§ã‚’壊ã™æ‹¡å¼µãŒå¿…è¦ãªå ´åˆã¯ã€é–¢æ•°åを変ãˆã‚‹ å¤ã„関数ã¯å¾“æ¥ã¨åŒã˜æ©Ÿèƒ½ã‚’
Understanding HATEOAS
HATEOAS (Hypermedia as the Engine of Application State) is a constraint of the REST application architecture. A hypermedia-driven site provides information to navigate the site's REST interfaces dynamically by including hypermedia links with the responses. This capability differs from that of SOA-based systems and WSDL-driven interfaces. With SOA, servers and clients usually must access a fixed sp
Rebuild: 35: You Don't Need API Version 2 (Kenn Ejima)
江島å¥å¤ªéƒŽã•ã‚“をゲストã«è¿Žãˆã¦ã€Satoshi Nakamotoã€Mt. Goxã€Macbook Proã€Digital Oceanã€ãƒªãƒ¢ãƒ¼ãƒˆãƒ¯ãƒ¼ã‚¯ã€API ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ãªã©ã«ã¤ã„ã¦è©±ã—ã¾ã—ãŸã€‚ スãƒãƒ³ã‚µãƒ¼: Ruby on Rails ãƒãƒ¥ãƒ¼ãƒˆãƒªã‚¢ãƒ« 0:00 miyagawa: Satoshi Nakamoto。 kenn: （笑）紛らã‚ã—ã„åå‰ã よã。 miyagawa: ä¼¼ãŸã‚ˆã†ãªåå‰ã®å‹ã ã¡ã¨ã‹çµæ§‹ã„ã‚‹ã‚“ã§ç´›ã‚‰ã‚ã—ã„ã‚“ã§ã™ã‘ã©ã‚‚。Newsweek ãŒã€Œã“ã„ã¤ãŒ Satoshi Nakamoto ã ã€ã£ã¦è¨€ã£ã¦è¨˜äº‹ã‚’出ã—ãŸã‚“ã ã‘ã©ã€‚ãƒã‚¹ã‚¢ãƒ³ã‚¼ãƒ«ã‚¹éƒŠå¤–ã«ä½ã‚€67æ³ã®æ—¥ç³»ã‚¢ãƒ¡ãƒªã‚«äººã§ã™ã‹ã€‚ kenn: ãªã‚“ã‹è¦‹ãŸã“ã¨ã‚ã‚‹æ„Ÿã˜ã®äººã よã。 miyagawa: ã¡ã‚‡ã£ã¨è¦‹ãŸç›®ãŒã€Œã‚ã‚Œã£ï¼Ÿã€ã£ã¦æ„Ÿã˜ãªã‚“ã ã‘ã©ã€‚鉄é“オタクã§ã。昔政府系ã®çµ„ç¹”ã§ã‚³ãƒ³ãƒˆãƒ©ã‚¯ãƒˆã‚’ã‚„ã£ã¦ã„ã¦ã€æ•°å¦ã«è©³ã—ãã¦ã€ã¿ãŸã„
例ãˆã° OSFA 㪠API ã‚’ã‚„ã‚ã‚‹ - @kyanny's blog
OSFA == one-size-fits-all å˜ä¸€ã® API ã§å…¨ã¦ã‚’ã‚«ãƒãƒ¼ã™ã‚‹ã®ã‚’ã‚„ã‚ãŸã‚‰ã©ã†ã‹ã€ã¨ã„ã†ã“ã¨ã€‚ APIã®ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã¯é™å±€åˆ†å²ã§ã‚„ã‚‹ã®ãŒè‰¯ã„ - Hidden in Plain Sight @kenn 最近ã¯RESTfulãªã‚¨ãƒ³ãƒ‰ãƒã‚¤ãƒ³ãƒˆã¯å®Œå…¨ã«å¾Œæ–¹äº’æ›ãªã¾ã¾ã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã”ã¨ã«ã‚ªãƒ¼ã‚±ã‚¹ãƒˆãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³å±¤(radical versionin)ã‚’è¨ã‘ã‚‹ã¨ã„ã†æ–¹å‘ã«ã‚·ãƒ•ãƒˆã—よã†ã¨ã—ã¦ã„る。詳ã—ã㯠http://t.co/zODm7mFr5B— Tatsuhiko Miyagawa (@miyagawa) February 28, 2014 ã“ã®è©±ã®ãƒã‚¤ãƒ³ãƒˆã¨ã¯ã¡ã‚‡ã£ã¨ãšã‚Œã¦ã‚‹ && Podcast è´ã„ã¦ãªã„ã®ã§ã™ãŒã€‚ Quipper プラットフォームã§å†…部的ã«åˆ©ç”¨ã•ã‚Œã¦ã„ã‚‹ API も〠/v1 ã¨ã„ã†ãƒ‘スã®ä¸‹ã«ã¯ãˆã¦ã¦ã”ã一部ã®ã‚¨ãƒ³ãƒ‰ãƒã‚¤ãƒ³ãƒˆã ã‘ /v2 ãŒã‚ã‚‹ã€ã¿
メンテナンス
ãŠçŸ¥ã‚‰ã›
障害
リリースã€éšœå®³æƒ…å ±ãªã©ã®ã‚µãƒ¼ãƒ“スã®ãŠçŸ¥ã‚‰ã›
最新ã®äººæ°—エントリーã®é…ä¿¡
j次ã®ãƒ–ックマーク
kå‰ã®ãƒ–ックマーク
lã‚ã¨ã§èªã‚€
eコメント一覧を開ã
oページを開ã
実践ï¼ãƒžã‚¤ã‚¯ãƒã‚µãƒ¼ãƒ“ス
api-guidelines/Guidelines.md at master · microsoft/api-guidelines
{{#tags}}- {{label}}
{{/tags}}