PokéAPI
SubmitNeed a hint? Try pokemon/ditto, pokemon-species/aegislash, type/3, ability/battle-armor, or pokemon?limit=100000&offset=0. Direct link to results: https://pokeapi.co/api/v2/pokemon/ditto Resource for ditto { "abilities": [ { "ability": { "name": "imposter", "url": "https://pokeapi.co/api/v2/ability/150/" }, "is_hidden": true, "slot": 3 }, { "ability": { "name": "limber", "url": "https://poke
ãƒã‚±ãƒ¢ãƒ³æƒ…å ±APIを作ã£ãŸ - Qiita
ã¤ã„ã«å‡ºã¾ã—ãŸãã€ãƒã‚±ãƒ¢ãƒ³GOï¼æµè¡Œã‚Šã™ãŽã§ã™ï¼w ã“ã‚Œã«ä¹—ã£ã‹ã£ã¦ãƒã‚±ãƒ¢ãƒ³æƒ…å ±APIを作ã£ã¦ã¿ã¾ã—ãŸã€‚ 今ã®ã¨ã“ã‚ã¯151匹ã®ã‹ã‚“ãŸã‚“ãªæƒ…å ±ã‚’è¿”ã™ã ã‘ã§ã™ãŒã€è¦æœ›ãªã©ã„ãŸã ã‘ã‚Œã°æ©Ÿèƒ½è¿½åŠ ã—ã¦ã„ã“ã†ã¨æ€ã„ã¾ã™ã€‚ サンプル → http://pokemonapi.net/pokemon/1.json アプリやWebサービスã§ãƒã‚±ãƒ¢ãƒ³æƒ…å ±ã‚’æä¾›ã—ãŸã„ 実ã¯ãƒã‚±ãƒ¢ãƒ³ã®ã“ã¨ã‚ã‚“ã¾ã‚ŠçŸ¥ã‚‰ãªã„（やã£ãŸã“ã¨ãªã„） 昔ã¯ãƒã‚±ãƒ¢ãƒ³ã‚„ã£ã¦ãŸã‘ã©çµæ§‹å¿˜ã‚Œã¦ã‚‹ ã¿ãŸã„ãªã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã®æ–¹ã«åˆ©ç”¨ã—ã¦ã„ãŸã ã‘ã‚Œã°ã¨æ€ã„ã¾ã™ã€‚ è¦æœ›ãªã©ã‚ã‚Šã¾ã—ãŸã‚‰ã€ã“ã®è¨˜äº‹ã‹Twitterã‚ãŸã‚Šã«é€£çµ¡ãã ã•ã„。
| docomo Developer support | NTTドコモ
API共通 ガイドライン ドコモã®APIã®ã”利用ã«ã‚ãŸã£ã¦ã€å…±é€šã§å¿…è¦ã¨ãªã‚‹æƒ…å ±ã®ã”案内ã§ã™ã€‚ よãã‚ã‚‹ã”è³ªå• APIãªã©ã®å„サービスã«é–¢ã™ã‚‹ã‚ˆãã‚る質å•ã‚’掲載ã—ã¾ã™ã€‚ ãŠå•ã„åˆã‚㛠「docomo Developer supportã€åŠã³ã€Œä½œã‚ã†ã‚¹ãƒžãƒ¼ãƒˆãƒ•ã‚©ãƒ³/iモードコンテンツã€ã«é–¢ã™ã‚‹ãŠå•ã„åˆã‚ã›ã§ã™ã€‚よãã‚ã‚‹ã”質å•ã‚„技術ブãƒã‚°ã§è§£æ±ºã—ãªã„å ´åˆã¯ã€ãŠå•ã„åˆã‚ã›ãã ã•ã„。
The Hypertext Application Language
HAL - Hypertext Application Language A lean hypermedia type Author: Mike Kelly <[email protected]> Created: 2011-06-13 Updated: 2013-09-18 (Updated) Summary HAL is a simple format that gives a consistent and easy way to hyperlink between resources in your API. Adopting HAL will make your API explorable, and its documentation easily discoverable from within the API itself. In short, it will make yo
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
RESTful Hypermedia API 概è¦ç·¨ | DevelopersIO
モãƒã‚¤ãƒ«ã‚¢ãƒ—リサービス部ã®äº”ååµã§ã™ã€‚ 最近『ãƒã‚¤ãƒ‘ーメディアAPIã€ã¨ã„ã†è¨€è‘‰ã‚’知ã£ã¦ã€èˆˆå‘³ãŒæ¹§ã„ãŸã®ã§èª¿ã¹ã¦ã¿ã¾ã—ãŸã€‚ã“ã‚Œã‹ã‚‰ä½•å›žã‹ã«åˆ†ã‘ã¦ã€ãƒã‚¤ãƒ‘ーメディアAPIã¨ã¯ä½•ã‹ã€Ruby on Railsã§ã®ã‚µãƒ¼ãƒå´ã®å®Ÿè£…方法ã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆå´ã®å®Ÿè£…方法ãªã©ã‚’紹介ã—ã¦ã„ããŸã„ã¨æ€ã„ã¾ã™ã€‚ 1回目ã®æœ¬è¨˜äº‹ã§ã¯ã€ãƒã‚¤ãƒ‘ーメディアAPIã®æ¦‚è¦èª¬æ˜Žã¨ã—ã¦ã€ç”¨èªžã®èª¬æ˜Žã‚„ç™»å ´ã®èƒŒæ™¯ã€ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆãªã©ã‚’紹介ã—ã¦ã„ãã¾ã™ã€‚特ã«æ³¨æ„ãŒãªã„é™ã‚ŠAPIã¯Web APIを指ã—ã¾ã™ã€‚ãªãŠã€ç”¨èªžã®å®šç¾©ã¨ã„ã†ã®ã¯å¾€ã€…ã«ã—ã¦è°è«–ã®å¯¾è±¡ã«ãªã‚Šã‚„ã™ã„ã§ã™ãŒã€ã“ã“ã§ã§èª¬æ˜Žã™ã‚‹ã®ã¯åŽ³å¯†ãªå®šç¾©ã§ã¯ãªã広義ã®å®šç¾©ã¨æ‰ãˆã¦ãã ã•ã„。ãã‚Œã§ã‚‚ç§ã®èªè˜ã«èª¤ã‚ŠãŒã‚ã‚‹å ´åˆã¯ã€ãã£ã¨ã”指摘ã„ãŸã ã‘ã‚‹ã¨å¹¸ã„ã§ã™ã€‚ 用語ã®èª¬æ˜Ž RESTful APIã¨ã¯ ã¾ãšã¯RESTful APIã«ã¤ã„ã¦ç°¡å˜ã«ãŠã•ã‚‰ã„ã‚’ã—ã¾ã™ã€‚RESTã¯åˆ†æ•£ã•ã‚ŒãŸæƒ…å ±ã‚’æ‰±ã†ãŸã‚ã®
ç¾å®Ÿä¸–ç•Œã®JSON Hyper-Schema / Real World JSON Hyper-Schema
Ruby Business User Conference 2015ã§ã®ç™ºè¡¨è³‡æ–™ã§ã™ã€‚
Web APIã®ãŸã‚ã®JSON Hyper-Schema - Tbpgr Blog
Web APIã®ãŸã‚ã®JSON Hyper-Schemaã«ã¤ã„㦠2015/08/05追記。DeNAã®æ¸…水直樹ã•ã‚“ã®ã‚¹ãƒ©ã‚¤ãƒ‰ã‚’è¿½åŠ ã—ã¾ã—㟠JSON Hyper-Schemaã«ã¤ã„㦠下記をå‚ç…§ JSON Schema Official å¿…è¦æ€§ APIã®é‹ç”¨ã«ã¯APIドã‚ュメントãŒå¿…è¦ APIã®å®Ÿè£…ã¨ãƒ‰ã‚ュメントã®å·®ç•°ã‚’ãªãã™å¿…è¦ãŒã‚ã‚‹ JSON Hyper-Schemaを活用ã™ã‚‹ã“ã¨ã§ä»¥ä¸‹ã®ã‚ˆã†ãªãƒ¡ãƒªãƒƒãƒˆãŒã‚ã‚‹ DSLç‰ã§ä½œæˆã—ãŸã‚¯ãƒ©ã‚¹ã‚’å…ƒã«JSON Schemaを生æˆã™ã‚‹ã“ã¨ã§ã‚³ãƒ¼ãƒ‰ã¨Schemaã®æ•´åˆæ€§ãŒã¨ã‚Œã‚‹ Schemaã‚’å…ƒã«APIドã‚ュメントを生æˆã™ã‚‹ã“ã¨ãŒã§ãã‚‹ Schemaã‚’å…ƒã«ValidationãŒå¯èƒ½ã«ãªã‚‹ Schemaã‚’å…ƒã«Clientアプリケーションã®è‡ªå‹•ç”Ÿæˆã§ãã‚‹ スライド GMOペパボã®é«˜æ©‹å¥ä¸€ã•ã‚“ DeNAã®æ¸…水直樹ã•ã‚“ JSON Schema 㨠API テ
Isomorphicã¨APIファーストã«ã¤ã„㦠#apijp
「Web API Advent Calendar 2014 ã®ï¼•æ—¥ç›®ã®è¨˜äº‹ã§ã™ã€‚〠最近ã€Isomorphicã¨ã„ã†è¨€è‘‰ã‚’よãèžã。 Isomorphicã¨ã¯ã€ã‚µãƒ¼ãƒãƒ¼ã¨ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã®ã‚³ãƒ¼ãƒ‰ã‚’åŒæ™‚ã«è¨˜è¿°ã™ã‚‹ãƒ‘ラダイムã®ã“ã¨ã 。 ã¤ã¾ã‚Šã€ãƒ•ãƒãƒ³ãƒˆã‚¨ãƒ³ãƒ‰ãƒ»ãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ã‚’曖昧ã«ã™ã‚‹ã‚ˆã†ãªã‚¢ãƒ¼ã‚テクãƒãƒ£ã§ã‚る。 ç§ã¯ã€Isomorphicã¯Webã®ã‚¢ãƒ¼ã‚テクãƒãƒ£ãƒ¼ã«åˆã£ã¦ã„ãªã„ã¨æ€ã£ã¦ã„ã¦ã€ã‚„ã¯ã‚ŠAPIファーストã§è¨è¨ˆã—ã€ãƒ•ãƒãƒ³ãƒˆã‚¨ãƒ³ãƒ‰ãƒ»ãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ã‚’ãã¡ã‚“ã¨åˆ†ã‘ã‚‹ã¹ãã ã¨è€ƒãˆã¦ã„る。 ã“ã®ç‚¹ã«ã¤ã„ã¦è©³ã—ãè¿°ã¹ãŸã„ã¨æ€ã†ã€‚ Isomorphicãªé–‹ç™ºç’°å¢ƒãŒæ±‚ã‚られる背景 Isomorphicãªé–‹ç™ºç’°å¢ƒãŒæ±‚ã‚られるç†ç”±ã¨ã—ã¦ã¯ã€ã“ã¡ã‚‰ã®Meteorã®è¨˜äº‹ãŒå¤§å¤‰ã‚ã‹ã‚Šã‚„ã™ã„。(リアルタイムWebアプリケーションフレームワークMeteorã«ã¤ã„ã¦) 普通ã®Webã§ã¯çŠ¶æ…‹ãŒç”»é¢é·ç§»ã§ãƒªã‚»ãƒƒãƒˆã•ã‚Œã¦ã—ã¾ã†ã“
ã„ã‚ã„ã‚ãªã‚µãƒ¼ãƒ“スã®APIã‚’curlã§å©ãã¨ãã®èªè¨¼ã®æ‰±ã„ - Qiita
URLã®ãƒªã‚¯ã‚¨ã‚¹ãƒˆãƒ‘ラメタã«?token=YOURTOKENã®ã‚ˆã†ã«ä»˜åŠ ã—ã¦ãƒªã‚¯ã‚¨ã‚¹ãƒˆã‚’é€ã‚‹ï¼Ž Qiita APIドã‚ュメント - Qiita:Developer ãªãŠ, ユーザå+パスワードを/api/v1/authã«postã™ã‚Œã°tokenã‚’å–å¾—ã§ãã‚‹. GitHub Basicèªè¨¼, OAuth2トークン（ヘッダー or パラメータ）ã®3種類ãŒä½¿ãˆã‚‹.
Amazon API Gatewayã§APIã‚ーèªè¨¼ã‚’è¨å®šã™ã‚‹ | DevelopersIO
ã©ã‚‚ã€å¤§ç€§ã§ã™ã€‚ AWS Summit NewYorkã§ç™ºè¡¨&リリースã•ã‚ŒãŸAmazon API Gatewayã‚’ã„ã‚ã„ã‚触ã£ã¦ã„ã¾ã™ã€‚API Gatewayã®æ©Ÿèƒ½ã®ä¸€ã¤ã¨ã—ã¦ã€èªè¨¼æ©Ÿæ§‹ã®è¿½åŠ ãŒã‚ã‚Šã¾ã™ã€‚今回ã¯API GatewayãŒã‚µãƒãƒ¼ãƒˆã™ã‚‹èªè¨¼ã®ä¸€ã¤ã¨ã—ã¦ã€APIã‚ーèªè¨¼ã‚’紹介ã—ã¦ã¿ã¾ã™ã€‚ APIã‚ーèªè¨¼ã¨ã¯ API Gatewayã®APIã‚ーèªè¨¼ã¯éžå¸¸ã«ã‚·ãƒ³ãƒ—ルã§ã€æ‰€å®šã®ã‚ー(æ–‡å—列)を所定HTTPヘッダ(x-api-keyヘッダ)ã«å«ã‚ãŸãƒªã‚¯ã‚¨ã‚¹ãƒˆã§ã‚ã‚Œã°ã‚¢ã‚¯ã‚»ã‚¹è¨±å¯ã€ç„¡ã‘ã‚Œã°ã‚¢ã‚¯ã‚»ã‚¹æ‹’å¦ã¨ã™ã‚‹æ©Ÿèƒ½ã§ã™ã€‚ APIã‚ーã¯ã€API Gatewayã§ç”Ÿæˆãƒ»ç®¡ç†ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã£ã¦ãŠã‚Šã€ã‚»ã‚ュアãªé‹ç”¨ãŒå¯èƒ½ã§ã™ã€‚ å‰æã®æ§‹æˆ 以下ã®è¨˜äº‹ã®ã‚»ãƒƒãƒˆã‚¢ãƒƒãƒ—ãŒå®Œäº†ã—ã¦ã„る状態ã§ã™ã€‚ Amazon API Gateway – API作æˆã‹ã‚‰å‹•ä½œç¢ºèªã¾ã§ã‚„ã£ã¦ã¿ã‚‹ ｜ Developers.IO gr
APIs: A Strategy Guide ã‚’èªã‚“ã - @kyanny's blog
APIs: A Strategy Guide ã‚’èªã‚“ã 。 ã“ã®æœ¬ã¯ API ã®è¨è¨ˆã‚„実装ã«é–¢ã™ã‚‹æœ¬ã§ã¯ãªã„。もã£ã¨å¤§å±€çš„ãªã€ API ã‚’å–ã‚Šå·»ãエコシステム全体ã®ã‚り方を論ã˜ã‚‹æœ¬ã ã£ãŸã€‚è¦ã™ã‚‹ã«ã€é–‹ç™ºè€…視点ã§ã¯å¾—ã‚‹ã‚‚ã®ãŒå°‘ãªã‹ã£ãŸã€‚ã¨ã¯ã„ãˆä¸€ãƒ¶æœˆåŠè¿‘ãã‹ã‘ã¦ä¸»ã«é€šå‹¤ä¸ã«ã€æœ€å¾Œã®ã»ã†ã¯ã™ã£ã¨ã°ã—ãªãŒã‚‰ã€ç„¡ç†ã‚„ã‚Šèªã‚“ã ã®ã§ç« ã”ã¨ã®ã–ã£ãã‚Šã—ãŸã¾ã¨ã‚ã¨æ„Ÿæƒ³ã‚’書ã。 Chapter 1 The API Opportunity ãã‚‚ãã‚‚ãªã‚“㧠API ãŒã‚ã‚‹ã¨è‰¯ã„ã®ã‹ã«ã¤ã„ã¦ãƒ“ジãƒã‚¹çš„ãªè¦–点ã§è§¦ã‚Œã¦ã„る。スマートフォンã®ã‚ˆã†ãªãƒªãƒƒãƒãªãƒ¢ãƒã‚¤ãƒ«ç«¯æœ«ãŒä¸–ç•Œä¸ã§çˆ†ç™ºçš„ã«æ™®åŠã—ã¦ã„ã‚‹ã®ã§ã•ã¾ã–ã¾ãªãƒ‡ãƒã‚¤ã‚¹å‘ã‘ã«ç´ æ—©ãコンテンツをæä¾›ã§ãã‚‹ã‹ã©ã†ã‹ãŒé‡è¦ã«ãªã‚‹ã€ãã“㧠API ã§ã™ã‚ˆã€ã¨ã„ã†æµã‚Œã€‚ ã‚ã¨ä¸€èˆ¬ã« API ã¨ã„ã†ã¨ä¸€èˆ¬ã«å…¬é–‹ã—ã¦ã‚µãƒ¼ãƒ‰ãƒ‘ーティã®é–‹ç™ºè€…ã«åˆ©ç”¨ã—ã¦ã‚‚らㆠpublic API を想åƒã—
Netflixã®API最é©åŒ–
先月1ヶ月間ã«æ¸¡ã£ã¦ã€Netflixã¯åŒç¤¾ãŒ1年以上å‰ã«å§‹ã‚ãŸAPI最é©åŒ–ã«é–¢ã™ã‚‹è©±ã‚’発表ã—ãŸã€‚当åˆã¯é€šä¿¡ã‚’å°‘ãªãã—ペイãƒãƒ¼ãƒ‰ã®ã‚µã‚¤ã‚ºã‚’å°ã•ãã™ã‚‹ã“ã¨ã§æ€§èƒ½ã®æœ€é©åŒ–ã—よã†ã¨ã—ã¦ã„ãŸ[1]ãŒã€1å¹´ã«ã‚ãŸã‚‹å†è¨è¨ˆã®çµæžœã€APIã®é–‹ç™ºã¨é‹ç”¨ã‚’分散化ã—サービス層ã¯éžåŒæœŸã«ãªã£ãŸã€‚å†è¨è¨ˆã®ç¬¬ä¸€ã®ç‰¹å¾´ã¯ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã¨ã‚µãƒ¼ãƒã®è²¬ä»»ã®å¢ƒç•Œ[2]ã‚’å†å®šç¾©ã—ãŸã“ã¨ã 。ã“ã†ã™ã‚‹ã“ã¨ã§ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã®ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒ†ã‚£ãƒ³ã‚°ãªã©ãã‚ç´°ã‹ã„カスタマイズãŒå¯èƒ½ã«ãªã‚Šã€Netflixã«æŽ¥ç¶šã™ã‚‹å¤šæ§˜ãªã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆãƒ‡ãƒã‚¤ã‚¹é–“ã®å·®ç•°(メモリã€ã‚ャパシティã€ãƒ‰ã‚ュメントé…ä¿¡ã€ãƒ¢ãƒ‡ãƒ«ã€ãƒ¦ãƒ¼ã‚¶ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹)ã«å¯¾å‡¦ã§ãる。 InfoQã¯Netflixã®ã‚·ãƒ‹ã‚¢ã‚½ãƒ•ãƒˆã‚¦ã‚¨ã‚¢ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã§ã‚ã‚‹Ben Christensenæ°ã«è¨è¨ˆã®è©³ç´°ã«ã¤ã„ã¦è©±ã‚’èžã„ãŸã€‚ InfoQ: 1å¹´å‰ã€æ€§èƒ½æœ€é©åŒ–を始ã‚ãŸã“ã‚ã®Netflix APIã®ã‚¢ãƒ¼ã‚テクãƒãƒ£ã‚’æ•™ãˆ
[ãã®ï¼‘] 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ãŒæ¨™æº–çš„ã«ãªã£ã¦ã„ã‚‹
swagger-expressを使ã£ã¦ç°¡å˜ã«APIドã‚ュメントを作æˆã™ã‚‹ - Qiita
APIドã‚ュメントツールã«swaggerã¨ã„ã†ã‚‚ã®ãŒã‚ã‚Šã¾ã™ã€‚ å…¬å¼ã®ãƒ‡ãƒ¢ ドã‚ュメントã«è¨˜è¼‰ã—ãŸAPIã®ä¸€è¦§ã‚’表示㗠パラメータãªã©ã‚’直接入力ã—ã¦ãã®å ´ã§è©¦ã›ã‚‹ã¨ã„ã†ã‚‚ã®ã§ã™ã€‚ facebookã®Graph API Explorerã‚„ twitterã® https://dev.twitter.com/console ã¨åŒã˜ã‚ˆã†ãªä½ç½®ã¥ã‘ã§ã™ã€‚ ã™ã¹ã¦è¨å®šã™ã‚‹ã¨ã¨ã¦ã‚‚便利ãªã®ã§ã™ãŒã€ ドã‚ュメント元ã¨ãªã‚‹JSONã®ä½œæˆãŒå¿…è¦ã§ã‚ã£ãŸã‚Šã€ 使ã„ã“ãªã™ã®ãŒçµæ§‹å¤§å¤‰ã ã£ãŸã‚Šã—ã¾ã™ã€‚ ãŸã swagger-expressを使ã†ã¨ 出æ¥ã‚‹ã ã‘ç°¡å˜ã«ãƒ‰ã‚ュメント化ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚ swaggerã®æ§‹æˆ ブラウザã§ã®è¡¨ç¤ºã®ãŸã‚ã®index.htmlã‚„js,css,imgãªã©ãŒã‚ã‚‹ã€swagger-ui APIã®æƒ…å ±ãŒã¾ã¨ã‚られã¦ã„ã‚‹ è¨ç½®ã®ä»•æ–¹ expressを使ã£ãŸã‚¢ãƒ—リ sampleApp 上ã§ã€
JSON Hyper-Schema ã‹ã‚‰APIドã‚ュメントã¨Goã®ã‚³ãƒ¼ãƒ‰ã‚’自動生æˆã™ã‚‹ | The Wacul Blog
３行ã§è¨€ã†ã¨ herokuãŒä½œã£ã¦ã‚‹ prmd を使ã£ã¦ã€JSON Schemaã‹ã‚‰APIドã‚ュメントを出力ã—ãŸã‚ˆï¼ スã‚ーマ定義ã‹ã‚‰ã€Goã®API実装コードも出力ã™ã‚‹ãƒ„ールを作ã£ãŸã‚‰ã‚ã£ã¡ã‚ƒæ—ã‚‹ã‚ˆï¼ Goã®ãƒãƒªãƒ‡ãƒ¼ã‚·ãƒ§ãƒ³ç”¨ã®ãƒ©ã‚¤ãƒ–ラリも作ã£ãŸã‚ˆï¼ 今回作ã£ãŸã‚‚ã®ã®æ¦‚è¦ã¨ã‚µãƒ³ãƒ—ルコード æ¦‚è¦ ä»¥å‰ã‹ã‚‰ã€APIを開発ã™ã‚‹ä¸Šã§ã€ä»¥ä¸‹ã®ã‚ˆã†ãªã“ã¨ãŒèª²é¡Œã¨ãªã£ã¦ã„ã¾ã—ãŸã€‚ ãã‚‚ãもドã‚ュメント書ãã®ãŒã¤ã‚‰ã„ ãれもã‚ã£ã¦ã€ãƒ‰ã‚ュメントより先ã«ã‚³ãƒ¼ãƒ‰ãŒå¤‰ã‚ã£ã¦ã—ã¾ã† ドã‚ュメントã¨å®Ÿè£…ã®çŠ¶æ³ã®é•ã„ãŒæŠŠæ¡ã—ã¥ã‚‰ã„ ã¾ãŸã€ãƒã‚¸ãƒƒã‚¯ãŒãã‚“ãªã«è¤‡é›‘ã§ã¯ãªã„APIã§ã¯ã€å®Ÿè£…ã®ä½œæ¥ã¯ リクエストデータã®ãƒãƒªãƒ‡ãƒ¼ã‚·ãƒ§ãƒ³ 出力データã®æ•´å½¢ (フィルタリング) ã®ï¼’ã¤ã®ä½œæ¥ãŒå¤§ããªå‰²åˆã‚’å ã‚ã¾ã™ã€‚ APIã®å®šç¾©ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ãƒ‰ã‚ュメントã¨ã€ãƒãƒªãƒ‡ãƒ¼ã‚·ãƒ§ãƒ³ã‚„出力データ整形ã®ã‚³ãƒ¼ãƒ‰ã‚’自動生æˆã§ãã‚Œã°ã€å¤§å¹…ã«åŠ¹çŽ‡ãŒä¸ŠãŒã‚‹ã¨æ€
モãƒã‚¤ãƒ«ã‚¢ãƒ—リã®ãƒ¦ãƒ¼ã‚¶èªè¨¼æ–¹æ³•ã«ã¤ã„ã¦ã¾ã¨ã‚ã¦ã¿ãŸ - Qiita
追記 (2018-10-08) 4年以上å‰ã«æ›¸ã„ãŸè¨˜äº‹ã§ã™ãŒã€Access Token ã¨ã—㦠JWT を利用ã™ã‚‹ã“ã¨ã¯éžæŽ¨å¥¨ãªã‚ˆã†ãªã®ã§ã€ãŠè©«ã³ã—ã¦ä¿®æ£è‡´ã—ã¾ã™ã€‚ å‚考: ã©ã†ã—ã¦ãƒªã‚¹ã‚¯ã‚¢ã‚»ã‚¹ãƒ¡ãƒ³ãƒˆã›ãšã« JWT をセッションã«ä½¿ã£ã¡ã‚ƒã†ã‚ã‘？ æ¦‚è¦ ã¿ã‚“ãªã‚„ã£ã¦ã‚‹ã¯ãšãªã‚“ã ã‘ã©ã€ã‚ã¾ã‚Šã¾ã¨ã¾ã£ãŸæƒ…å ±ãŒãªã‹ã£ãŸã®ã§æ›¸ã„ã¦ã¿ã¾ã™ã€‚èªè¨¼å‘¨ã‚Šã¯ã‚»ã‚ュリティを気ã«ã—ã¦ã€ã¿ã‚“ãªæ›¸ããŸãŒã‚‰ãªã„ã®ã‹ãªï¼Ÿãã‚Œã¨ã‚‚ç§ã®èª¿ã¹æ–¹ãŒæ‚ªã‹ã£ãŸã ã‘？マサカリãŠå¾…ã¡ã—ã¦ã¾ã™ã€‚ èªè¨¼ã®åŸºæœ¬æ–¹é‡ +--------+ +--------+ | | | | | |----(1) Credential ------------>| | | | | | | |<---(2) Access Token -----------| | | | | | | Client | | Server | | | | | | |----(3)
Qiita API v2ã®JSON Schemaを公開ã—ã¾ã—㟠- Qiita Blog
ã“ã‚“ã«ã¡ã¯ã€r7kamura ã§ã™ã€‚ 最近ã¯ä¸»ã«ã‚¤ã‚«ã¨ã—ã¦æ´»å‹•ã—ã¦ãŠã‚Šã€ã‚«ãƒ©ãƒ•ãƒ«ãªå¢¨ã‚’掛ã‘åˆã†æ—¥ã€…ã‚’é€ã£ã¦ã„ã¾ã™ã€‚ ã•ã¦ã€QiitaãŠã‚ˆã³Qiita Teamã§ã¯ã€Qiita API v2ã¨ã—ã¦ãƒ‡ãƒ¼ã‚¿ã‚’æ“作ã™ã‚‹ãŸã‚ã®REST APIを公開ã—ã¦ã„ã¾ã™ã€‚ã“ã‚Œã¾ã§é–‹ç™ºè€…å‘ã‘ã« APIドã‚ュメント ã‚’æä¾›ã—ã¦ã„ã¾ã—ãŸãŒã€ä»Šå›žã¯ä¸»ã«æ©Ÿæ¢°å‘ã‘ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã¨ã—ã¦ã€JSON Schemaã§è¨˜è¿°ã—ãŸREST APIã®ã‚¹ã‚ーマ定義 (以下スã‚ーマ) を公開ã™ã‚‹ã“ã¨ã«ãªã‚Šã¾ã—ãŸã€‚具体的ã«ã¯ã€JSON Hyper-Schema draft v4 を利用ã—ã¦å®šç¾©ã•ã‚Œã¦ã„ã¾ã™ã€‚ http://qiita.com/api/v2/schema Qiita API v2ã®ã‚¹ã‚ーマã®èª¬æ˜ŽQiita API v2ã®ã‚¹ã‚ーマã®æ§‹æˆã«ã¤ã„ã¦ç°¡å˜ã«èª¬æ˜Žã—ã¾ã™ã€‚スã‚ーマ㯠http://qiita.com/api/v2/sche
ãŠçŸ¥ã‚‰ã›
障害
ランã‚ング
リリースã€éšœå®³æƒ…å ±ãªã©ã®ã‚µãƒ¼ãƒ“スã®ãŠçŸ¥ã‚‰ã›
最新ã®äººæ°—エントリーã®é…ä¿¡
j次ã®ãƒ–ックマーク
kå‰ã®ãƒ–ックマーク
lã‚ã¨ã§èªã‚€
eコメント一覧を開ã
oページを開ã
JSON Schema 㧠Web API ã®ã‚¹ã‚マを埋ã‚よã†
WEB APIã®URLè¨è¨ˆã®ãƒˆãƒ¬ãƒ³ãƒ‰ã¯ã“ã‚Œã ï¼WEB APIã®URLè¨è¨ˆã¾ã¨ã‚
{{#tags}}- {{label}}
{{/tags}}