JPC2016: PUP-02: 今ã™ãã§ãるソフトウェア資産を活ã‹ã—㟠Azure ビジãƒã‚¹å±•é–‹ ～ ソフトウェア資産をãŠæŒã¡ã®æ–¹ã‚‚利用ã™ã‚‹æ–¹ã‚‚ ～
Heroku HTTP API Design Guide
JPC2016: PUP-02: 今ã™ãã§ãるソフトウェア資産を活ã‹ã—㟠Azure ビジãƒã‚¹å±•é–‹ ～ ソフトウェア資産をãŠæŒã¡ã®æ–¹ã‚‚利用ã™ã‚‹æ–¹ã‚‚ ～
アプリエンジニアã‹ã‚‰è¦‹ã¦APIè¨è¨ˆã«ãŠã„ã¦æ°—ã‚’ã¤ã‘ã¦ã‚‚らãˆã‚‹ã¨ã†ã‚Œã—ã„ã“㨠- Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? by @mixiappwchr アプリå‘ã‘ã®APIã®é–‹ç™ºæ™‚ã«æ°—ã‚’ã¤ã‘ã¦ã‚‚らãˆã‚‹ã¨ã†ã‚Œã—ã„＆メンテナンスや実装コストãŒä¸‹ãŒã‚‹ç‚¹ã‚’ã¤ã‚‰ã¤ã‚‰æ›¸ãã¾ã™ã€‚ ãƒ‡ãƒ¼ã‚¿æ§‹é€ ã«ã¤ã„㦠データを返ã™ã¨ãã€ä¸€å®šã®ãƒ«ãƒ¼ãƒ«ã‚’守ã£ã¦è¿”ã™ã€‚例ãˆã°å½“然ã§ã™ãŒåŒã˜ãƒ‡ãƒ¼ã‚¿æ§‹é€ ã¯ã‚‚ã¡ã‚ã‚“ã€ä¼¼ãŸã‚ˆã†ãªæ§‹é€ もルールを作ã£ã¦propertyåãªã©ãã‚ãˆã¦ãŠã。relationã‚„listã§è¿”ã™ã¨ãã‚‚ã©ã®ãƒ‡ãƒ¼ã‚¿æ§‹é€ ãªã®ã‹ãŒpropertyã§æ˜Žç¢ºã«ã‚ã‹ã‚‹ã‚ˆã†ãªã£ã¦ã„るよã†ã«ã™ã‚‹ listã‚’è¿”ã™å ´åˆã®å½¢å¼ã‚„pagingãŒå¿…è¦ãªå ´åˆã®å½¢å¼ã¯ãã‚ãˆã‚‹ã€‚é…列ã®ãƒ‡ãƒ¼ã‚¿ãŒãªã„å ´åˆã‚‚考慮ã—ã¦ãŠã。例
Swiftã§enumã¨ã‚¸ã‚§ãƒãƒªã‚¯ã‚¹ã‚’活用ã—ãŸã‹ã£ã“ã„ã„APIクライアントを書ã - Hatena Developer Blog
ã“ã®è¨˜äº‹ã¯ã¯ã¦ãªã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã‚¢ãƒ‰ãƒ™ãƒ³ãƒˆã‚«ãƒ¬ãƒ³ãƒ€ãƒ¼2014ã®16日目ã§ã™ã€‚昨日ã¯id:nobuokaã«ã‚ˆã‚‹ã€Œã€Retrofit ã‚’èªã‚€ã€‘ 利用者ãŒå®šç¾©ã—ãŸã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ã‚¤ã‚¹ã«å®Ÿè£…ã‚’æä¾›ã™ã‚‹ Java ライブラリã®ä½œã‚Šæ–¹ ã€ãƒªãƒ•ã‚¯ãƒ¬ã‚·ãƒ§ãƒ³ã€‘ã€ã§ã—ãŸã€‚ ã“ã‚“ã«ã¡ã¯ã€‚ã¯ã¦ãªã‚¢ãƒ—リケーションエンジニアã®id:cockscombã§ã™ã€‚ Webã¨é€£æºã™ã‚‹ã‚¹ãƒžãƒ¼ãƒˆãƒ•ã‚©ãƒ³ã‚¢ãƒ—リを開発ã™ã‚‹ã¨ãã€Web APIを抽象化ã—ãŸAPIクライアントを作るã“ã¨ãŒã‚ˆãã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯Web APIã®ã‚¨ãƒ³ãƒ‰ãƒã‚¤ãƒ³ãƒˆã¨ãƒ¡ã‚½ãƒƒãƒ‰ã‚’ç´ä»˜ã‘ã€ãƒ‘ラメータã«åå‰ã‚’ã¤ã‘ã¦ã€è¿”ã£ã¦ãã‚‹JSONã®ãƒ¬ã‚¹ãƒãƒ³ã‚¹ã‚’何らã‹ã®ã‚¯ãƒ©ã‚¹ã«å½“ã¦ã¯ã‚型付ã‘ã™ã‚‹ã€ã¨ã„ã£ãŸã‚ˆã†ãªã‚‚ã®ã«ãªã‚Šã¾ã™ã€‚ Swiftã®ãƒ¢ãƒ€ãƒ³ãªè¨€èªžæ©Ÿèƒ½ã‚’利用ã—ã¦ã€ã“ã®APIクライアントを書ãã¾ã—ãŸã®ã§ã€ä»¥ä¸‹ã«è©³è§£ã—ã¾ã™ã€‚例ã¨ã—ã¦GitHubã®Status APIã‚’å–り上ã’ã¦ã„ã¾ã™ã€‚ ã¾ãŸãƒãƒƒãƒˆãƒ¯
APIã®ã‚¨ãƒ©ãƒ¼ãƒãƒ³ãƒ‰ãƒªãƒ³ã‚°ã‚’見直ãㆠ- WebPay Engineering Blog
ã“ã“数ヶ月ã«ã‚ãŸã£ã¦ã€WebPayã¯APIã®ã‚¨ãƒ©ãƒ¼ã«ã¾ã¤ã‚る変更を少ã—ãšã¤è¡Œã£ã¦ãã¾ã—ãŸã€‚ ãã‚Œã«ä»˜éšã—ã¦ãƒ‰ã‚ュメントも拡張ã—ã¾ã—ãŸãŒã€å¤‰æ›´ã®èƒŒæ™¯ã«ã¤ã„ã¦å分ã«èª¬æ˜Žã§ãã¦ã„ãªã„部分ãŒã‚ã‚Šã¾ã—ãŸã€‚ ã“ã®è¨˜äº‹ã§ã¯ã€æœ€è¿‘ã®ã‚¨ãƒ©ãƒ¼ã«é–¢é€£ã—ãŸå¤‰æ›´ã®èƒŒæ™¯ã‚’紹介ã—ã€ä»Šå¾Œã©ã®ã‚ˆã†ã«ã‚¨ãƒ©ãƒ¼ã‚’ãƒãƒ³ãƒ‰ãƒ«ã™ã¹ãã‹èª¬æ˜Žã—ã¾ã™ã€‚ 記事ã®å†…容ã¯åŸ·ç†æ™‚点ã®ã‚‚ã®ã§ã‚ã‚Šã€ä»Šå¾ŒåŒã˜ã‚ˆã†ã«ã‚¨ãƒ©ãƒ¼ã‚„APIã®å¤‰æ›´ã‚’è¡Œã†ã“ã¨ãŒã‚ã‚Šã¾ã™ã€‚ 変更ãŒã‚ã£ã¦ã‚‚記事ã®å†…容ã¯ãã®æ™‚点ã®å†…容をä¿æŒã—ã€ã‚¦ã‚§ãƒ–サイトã®ãƒ‰ã‚ュメントã®ã¿æ›´æ–°ã—ã¾ã™ã€‚ å¿…ãšã‚¦ã‚§ãƒ–サイトã®ãƒ‰ã‚ュメントをåˆã‚ã›ã¦å‚ç…§ã—ã€æ‰‹å…ƒã§å‹•ä½œç¢ºèªã‚’è¡Œã£ã¦ãã ã•ã„。 エラーã¯ãªãœèµ·ãã‚‹ã®ã‹ WebPayã®APIã¯ã€ãƒªã‚¯ã‚¨ã‚¹ãƒˆã•ã‚ŒãŸæ“作ãŒã§ããªã‹ã£ãŸã¨ãã«ã‚¨ãƒ©ãƒ¼ã‚’è¿”ã™ã‚ˆã†ã«è¨è¨ˆã—ã¦ã„ã¾ã™ã€‚ å¯èƒ½ãªã‹ãŽã‚Šã‚¨ãƒ©ãƒ¼ã«ãªã‚‰ãªã„よã†ãªè¨è¨ˆã€å®Ÿè£…を心ãŒã‘ã¦ã„ã¾ã™ãŒã€ã‚¨ãƒ©ãƒ¼ã¯çµ¶å¯¾ã«é¿ã‘られã¾ã›ã‚“。 例ãˆã°ã€
クックパッドã¨ãƒžã‚¤ã‚¯ãƒã‚µãƒ¼ãƒ“ス - クックパッド開発者ブãƒã‚°
技術部ã®é«˜äº•ã§ã™ã€‚ 最近ã€æ—¥æœ¬ã§ã‚‚マイクãƒã‚µãƒ¼ãƒ“スã¨ã„ã†è¨€è‘‰ãŒæµè¡Œã—ã¤ã¤ã‚ã‚Šã¾ã™ã€‚ 今回ã¯ã€ãªãœã‚¯ãƒƒã‚¯ãƒ‘ッドãŒãƒžã‚¤ã‚¯ãƒã‚µãƒ¼ãƒ“スをé¸æŠžã—ãŸã®ã‹ã€ã¾ãŸå®Ÿéš›ã«ã©ã®ã‚ˆã†ãªã‚„り方をã—ã¦ã„ã‚‹ã®ã‹ã¨ã„ã†ã“ã¨ã‚’紹介ã—ã¾ã™ã€‚ Conwayã®æ³•å‰‡ ã“ã“æ•°å¹´ã®é–“ã€ã‚¯ãƒƒã‚¯ãƒ‘ッドã¯ãƒ¬ã‚·ãƒ”ã®æŠ•ç¨¿ãƒ»æ¤œç´¢ã‚µãƒ¼ãƒ“スã‹ã‚‰ã€Œé£Ÿã‚’ä¸å¿ƒã¨ã—ãŸç”Ÿæ´»ã®ã‚¤ãƒ³ãƒ•ãƒ©ã€ã¨ã—ã¦äº‹æ¥é ˜åŸŸã‚’拡大ã—ã¤ã¤ã‚ã‚Šã¾ã™ã€‚海外レシピサービスã®è²·åŽã«ã‚ˆã‚‹æµ·å¤–展開ã¯ã€å˜ãªã‚‹é‡‘éŠçš„ãªé–¢ä¿‚ã«ã¨ã©ã¾ã‚‰ãšã€äººçš„・技術的ãªäº¤æµã‚‚å«ã‚ã¦æœ¬æ ¼åŒ–ã—ã¤ã¤ã‚ã‚Šã¾ã™ã€‚ã¾ãŸã€ã€Œãƒ¢ãƒã‚¤ãƒ«ãƒ•ã‚¡ãƒ¼ã‚¹ãƒˆã€ã‚’標語ã¨ã™ã‚‹ãƒ¢ãƒã‚¤ãƒ«ã‚¢ãƒ—リケーションã¸ã®å–り組ã¿ã‚‚åŠ é€Ÿã—ã¦ãã¾ã—ãŸã€‚ 事æ¥é ˜åŸŸã®æ‹¡å¤§ã‚„ã‚°ãƒãƒ¼ãƒãƒ«å±•é–‹ã€ãƒ¢ãƒã‚¤ãƒ«ãƒ•ã‚¡ãƒ¼ã‚¹ãƒˆã¨ã„ã£ãŸãƒ“ジãƒã‚¹è¦æ±‚ã®å¤‰åŒ–ã«å¿œã˜ã¦ã€ä¼šç¤¾ã®çµ„ç¹”æ§‹é€ ã‚‚å¤‰åŒ–ã—ã¦ã„ã¾ã™ã€‚ãã—ã¦ã€Conwayã®æ³•å‰‡ ã¨ã—ã¦çŸ¥ã‚‰ã‚Œã¦ã„るよã†ã«ã€çµ„ç¹”æ§‹é€ ã¨ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚¢ãƒ¼ã‚テクãƒãƒ£ã«ã¯å¯†æŽ¥ãªé–¢ä¿‚ãŒã‚
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リク
モãƒã‚¤ãƒ«APIデザインã®ã¾ã¨ã‚ - ワザノム| wazanova
Natasha MurashevãŒãƒ–ãƒã‚°ã§ã€API Strategy and Practice Conferenceã«ãŠã‘ã‚‹ã€Michele Titolo (先月ã€ã€Œ Ruby Roguesメンãƒã¨iOSエンジニアã®APIè°è«–ã€ã§ç´¹ä»‹ã—ã¾ã—ãŸã€‚）ã¨Etsyã®Paul Wrightã®è¬›æ¼”ã®ãƒã‚¤ãƒ³ãƒˆã‚’ã¾ã¨ã‚ã¦ãã‚Œã¦ã„ã¾ã™ã€‚ 1) スピード ユーザã¯å¾…ã£ã¦ãã‚Œãªã„。300msã§ã€ãƒªã‚¯ã‚¨ã‚¹ãƒˆ / レスãƒãƒ³ã‚¹ã®å‡¦ç† / ユーザã«çµæžœã®è¡¨ç¤ºã‚’ã™ã‚‹ã€‚ 2) RESTãŒå¸¸ã«ãƒ™ã‚¹ãƒˆã¨ã¯é™ã‚‰ãªã„ 以å‰ã®Etsyã®APIリソースã¯DBスã‚ーマã®ãƒŸãƒ©ãƒ¼ã«ãªã£ã¦ã„ãŸã€‚クライアントãŒãƒªã‚¹ãƒ†ã‚£ãƒ³ã‚°ã®ãƒªã‚¹ãƒˆã‚’å—ã‘å–ã£ãŸã‚‰ã€ãƒ¦ãƒ¼ã‚¶ãŒFavoritedã«æŒ‡å®šã—ã¦ã„るリスティングIDã‚’å–å¾—ã™ã‚‹ãŸã‚ã«ã€å†åº¦APIコールã™ã‚‹å¿…è¦ãŒã‚ã£ãŸã€‚クライアントã®APIコールãŒå¢—ãˆã‚‹ã¨ã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã®ã‚¹ãƒ”ードãŒè½ã¡ã‚‹ã€‚ã¾ãŸéšœå®³ã®å¯èƒ½æ€§ã¨ãªã‚‹ãƒ
例ãˆã° 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 ãŒã‚ã‚‹ã€ã¿
APIã®ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã¯é™å±€åˆ†å²ã§ã‚„ã‚‹ã®ãŒè‰¯ã„ - Hidden in Plain Sight
ã¡ã‚‡ã£ã¨å‰ã«Twitterã§APIã®ãƒãƒ¼ã‚¸ãƒ§ãƒ‹ãƒ³ã‚°ã‚’ã©ã†ã‚„ã‚‹ã‹ã¿ãŸã„ãªè©±ã‚’ã—ã¦ã„ãŸã®ã§ã™ãŒã€ãã®ã¸ã‚“ã‚‚ã‚„ã‚‚ã‚„ã—ã¦ã„ã‚‹ã®ã§å°‘ã—æ•´ç†ã—ã¦ãŠããŸã„ãªã¨ã€‚ APIã®URLã‚’/api/v1/*ã¨ã‹ã£ã¦ã‚„ã‚‹ã®ã€ã‚„ã‚ãŸã»ã†ãŒã„ã„ã¨ãŠã‚‚ã†ã‚“ã ã‘ã©ãªã。ã„ã–v2を作るã¨ãªã£ãŸã¨ãã«ã€å¤§é‡ã®ã‚³ãƒ”ペãŒç™ºç”Ÿã—ã¦å¾Œæ‚”ã™ã‚‹ã‚ˆã€ã£ã¦ä¼ãˆãŸã„。— Kenn Ejima (@kenn) February 28, 2014 ã•ã¦ã€ã“ã‚Œã«ã¤ã„ã¦è‰²ã€…ã¨ç•°è«–・åè«–ã‚‚å«ã‚ãŸæ„見ãŒå‡ºãŸã®ã§ã™ãŒã€ã¾ãšã¯ã€å¤§æ˜”ã«URLæ–¹å¼ï¼ˆï¼ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©åˆ†å‰²ï¼‰ã§ã‚„ã£ã¦ãã¦å¾Œæ‚”ã—ãŸã¼ããŒã€ï¼ˆ5å¹´ãらã„å‰ã‹ã‚‰ï¼‰ç¾åœ¨ã¯ã©ã†ã‚„ã£ã¦APIã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’管ç†ã—ã¦ã„ã‚‹ã‹ï¼Ÿã«ã¤ã„ã¦ç´¹ä»‹ã—ã¾ã™ã€‚ 基本原ç†ã¨ã—ã¦ã¯ã€ã‚³ãƒ”ペãŒå¤šç™ºã™ã‚‹æ ¹ã£ã“ã§åˆ†å²ï¼ˆï¼ã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ©åˆ†å‰²ï¼‰ã˜ã‚ƒãªãã¦ã€å¿…è¦æœ€å°é™ã®ã¨ã“ã‚ã§é™å±€çš„ã«åˆ†å²ã™ã‚‹ã®ãŒã„ã„ã€ã¨ã„ã†è€ƒãˆæ–¹ã«åŸºã¥ãã¾ã™ã€‚ 一言ã§ã„ã†ã¨ã€ã€Œãƒ‘ラメー
1
リリースã€éšœå®³æƒ…å ±ãªã©ã®ã‚µãƒ¼ãƒ“スã®ãŠçŸ¥ã‚‰ã›
最新ã®äººæ°—エントリーã®é…ä¿¡
j次ã®ãƒ–ックマーク
kå‰ã®ãƒ–ックマーク
lã‚ã¨ã§èªã‚€
eコメント一覧を開ã
oページを開ã
Amazon.co.jp: API Design for C++: Reddy, Martin: 本
{{#tags}}- {{label}}
{{/tags}}