最近公開されたGitHubのAPIは、GraphQLという形式に対応しました。今後はこちらが主流になっていくようで、既存のREST APIからGraphQLへのマイグレーションガイドも提供されています。 今回は、このGraphQLについて、実際にGitHubのAPIを叩きながらその仕組みを解説していきたいと思います。 GraphQLとは 歴史 GraphQLは、Facebookの中で2012年ごろから使われ始めたそうです。その後2015年のReact.js Confで紹介されたところ話題となり、同年"technical preview"のステータスでオープンソースとして公開されました。その後仕様が詰められ、2016年9月に晴れて"preview"を脱し公式実装として公開されました。これと同じタイミングで、GitHubからGraphQLバージョンのAPIが公開されています。 このあたりの経緯
Send feedback API design guide Stay organized with collections Save and categorize content based on your preferences. Changelog Introduction This is a general design guide for networked APIs. It has been used inside Google since 2014 and is the guide that Google follows when designing Cloud APIs and other Google APIs. This design guide is shared here to inform outside developers and to make it eas
概念としてとしてのRESTは、 Roy Fielding が博士論文「 Architectural Styles and the Design of Network-based Software Architectures 」で導入したものです。その16年後、アーキテクチャとしてのRESTは、APIを設計・構築するための最も広く受け入れられた方法となっています。RESTについては私たちはみんな聞いたことがありますし、自分たちが実際にRESTfulなAPIを構築しているとほぼ皆が思っています。しかし、それは本当でしょうか？ 「RESTとは何か？」ということを自分たちにもう一度思い出させたうえで、さらにRESTを補う別の方法、「HATEOAS」と呼ばれるものの話に続けていきましょう。 RESTとは何か？をもう一度 私はこれを説明するための良い方法について考えていたのですが、Ryan Tomak
WebAPIの動作確認する際、GETはまだしもPUTやPOST、DELETEはどうやって確認するのが楽なんかなぁと。 仕方ないので簡単なフォームを作成して動作確認していたのですが、「.NET開発テクノロジ入門 2014年版 VisualStudio2013対応版 (MSDNプログラミングシリーズ)」にいいツールがさりげなく紹介されていました。 Chrome ウェブストア - Advanced REST client Chrome拡張ですが、自分はChromeをメインで使用しているので問題なし。 こんな風にPOSTするデータを指定したり 結果を見やすい形で表示してくれりします。 実行するパラメータは画面右上の「Save」からローカルやGoogleDriveに保存ができます。*1 *1:ちなみに、私の環境ではGoogleDriveに保存するといつまでも応答がなく、保存できないという現象が発生し
前回はNancyFxとTopShelfを使ったSelfHostなAPIサーバーについて紹介しました。 https://tech.guitarrapc.com/entry/2015/05/19/025657 しかしプロダクション環境に投入する前にNancyを辞めて、LightNodeに完全移行しました。 そこで今回は、なぜLightNodeにしたのかについて書きたいと思います。 なぜLightNode にしたのか SelfHost で受ける制限 リポジトリ LightNode の導入と移行 NuGet エラーの嵐 Configuration への LightNode 組み込み Api の作成 Api を Swaggerでテストする PowerShell での Apiアクセス LightNodeでのTips HTML でレンダリングされた Viewを返したい。 実装したApi の一覧を返したい
Single-page Application(SPA)によりフロント開発にかかる手間が膨大になっています。SPAの開発をするときに通信部分（JSONやJSONPなど）をどうすればいいのかが問題になります。解答としてはスタブAPIサーバを作成し対応します。 画面開発するためにアプリケーションサーバを構築するのは時間の無駄ですのでgruntタスクにモックサーバを構築し簡単実装を行いましょう。 「本物の」APIサーバを使う場合は向きを変えることで簡単に結合テストできますし、CIを使うときはもちろんモックサーバでのテストになりますのでモックAPIサーバは活用するのが良いと考えます。 モックAPIサーバ gruntでモック用APIサーバを立ち上げるためのプラグインとして有名なものとして２つ存在します。 grunt-easymock grunt-stubby easymockはnode-easymo
Swagger places API specifications such as OpenAPI, AsyncAPI, and JSON Schema at the core of its architecture, which are crucial for guiding teams through the entire lifecycle of API design and documentation. This strategic focus ensures that our suite, including open source tools and API Hub, delivers unparalleled efficiency and a seamless user experience. Explore the API Specifications Discover t
Web API Advent Calendar 2014、初日はSwaggerを紹介します。 SwaggerはReverbによって開発された、RestfulなAPIを記述する標準仕様です。APIを機械可読な形で記述することは、ドキュメント生成やツール開発、さまざまな形での自動化に非常に重要です。好き嫌いはともかく、SOAPにはWSDLという統一標準がありましたが、RESTには本質的にそういった標準がないため、類似するさまざまな仕様が開発されてきました。Swaggerはその中でも最も有望なものの一つだと思います。 1. 特徴 記述はJSONでシンプル。ミニマム定義の例： { "swagger": "2.0", "info": { "version": "1.0.0", "title": "petstore" }, "paths": { "/users": { "get": { "respon
移転しました http://please-sleep.cou929.nu/20130121.html
Memotuneでは現在、Web APIを開発している。GDataに準拠しているので、Web APIの形式はRESTfulだ。ただ、RESTfulは最近の流行とは言え、問題がない訳ではない。 最大の問題はテスト環境だ。PUTやDELETEといったHTTPメソッドを手軽に試せない。IEやFirefoxは対応しているようだが、おそらく手軽には試せないだろう。 そこで専用のクライアントを使うのが良い。RESTfulに限らず、XMLを経由したMashup開発者は必須ではないだろうか。 今回紹介するフリーウェアはeXeve、RESTfulなWebアプリケーション開発ユーティリティだ。 eXeveを使うとWeb APIとやり取りするXMLが簡単に作成できる。構造チェックやDTDによる検証ができればよけいなミスも減るはずだ。 また、PUTやDELETEといったHTTPメソッドを使ってデータを授受する事も
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
