今年GitHubがGraphQL APIを正式公開したあたりから、GraphQLが去年とかに比べちょっと流行り始めたように感じる。idobataがGraphQL APIを公開したり、Kibelaも公開APIをGraphQLで作ることを宣言している。 利用者側からすると使えるインターフェースの中から必要なものを調べて使うだけなのであまり考えることはないのだが、自分がAPIを提供する立場になると話は変わってくる。REST APIとGraphQL APIはどちらかがもう一方のスーパーセットという風にはなっておらず、どちらかを選択すると何かを捨てることになるので、要件に応じてどちらを選ぶのが総合的に幸せなのか考える必要がある。 以前趣味でGitHub連携のあるサービスを作っており、それを最近GraphQL API v4を使うように移行し、そこでついでにそのサービスのGraphQL APIを書いてみ
こんにちは丸山@h13i32maruです。 僕は2015年からESDoc*1というJavaScript向けのドキュメンテーションツールを開発しています。 https://esdoc.org https://github.com/esdoc/esdoc Star 最初のリリースから2年、昨日ようやくv1.0をリリースできました🎉 いやー、ここまで長かったです。今ではRxJSやSketchAPIなど、様々なツールで使用されています。 この2年間、ESDocは2つのゴールを目指して開発してきました。 ドキュメントの作成・メンテナンスを快適にする(ドキュメントを書くの楽しい!という状態) ソフトウェアの使い方を簡単に理解できるドキュメントを作成する(ソースコード読まなくても大丈夫!という状態) この2つを満たすためにESDocは色々な機能を提供しています。 今日はそれらの機能の中でも(多分)モダ
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための(レスポンスボディに載せられる)標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
炎上して GitHub アカウントが問答無用で停止されましたって話です。当事者としての経験や雑感など雑多にまとめましたので、参考になれば(なるのか?)幸いです。 経緯 ggc というリポジトリを作って遊んでいました。 ggc とは Github Girls Collection の略で、女性 GitHub アカウントを Markdown でまとめたリポジトリでした。実装としては、Followings(自分がフォローしたユーザ)の中から、あらかじめリストに書いておいた女性アカウント名のみを抽出して、アバター情報などを取得し、リスト化するというものでした。GitHub API を Python で叩いていました。 これが本日、おそらく このツイート を契機に炎上したようです。通報も行われたらしく、GitHub 側も通報を受け入れたようで、まず ggc リポジトリが disabled となり、ご
Wantedly Engineer blogに本速習会資料を閲覧向けに再編しました! ぜひご覧いただけると幸いです! 本記事は、綺麗なAPI速習会@Wantedlyの資料として作成されたものです。 同時にこちらのコードも参照してください。 マイクロサービス 流行りのマイクロサービス、何がいいのか 各々自由な言語やArchitectureでサービスを立てられる 障害の影響が部分的 変化に強い 個別デプロイ etc... マイクロサービス化をすすめるにあたり、やりとりは全てAPIで行う 内部のAPIであっても外部に公開できるようなクオリティのAPIを作成し、それを元にサービスを作っていくことが重要 APIGatewayとBFF API Gateway Pattern 公式サイトより 「見た目はモノリシック、実装はマイクロサービス」 一箇所見に行けば全てのAPIを見つけられる 細かい権限管理も可
We just added a new updated article that covers the same topic. You can find it here: Cookies vs Tokens: The definitive guide. Introduction There are basically two different ways of implementing server side authentication for apps with a frontend and an API: The most adopted one, is Cookie-Based Authentication (you can find an example here) that uses server side cookies to authenticate the user on
「商業利用もOK! Google Mapsについて知りたいこと」に続くGoogle Mapsインタビューの後編は、数多く存在するGoogle Maps関連のAPIや機能のうち、あまり知られていないものや新しいものをグーグルのソフトウェアエンジニア、淺川浩紀さんに聞いた。 Code Playgroundでオンライン編集 まずは、即効性のあるものからいこう。 Googleが持つ多くのAPIは、Webブラウザ上からJavaScriptによって呼び出せる。JavaScriptはコンパイルの手順なしに書けば実行できるので手軽である。しかし、だからAPIを試すのも簡単だとは限らない。例えば、Google Maps APIなら正しいGoogle Maps APIキーを用意したり、適切な文書にプログラムを埋め込んだりする作業を行い、それをWebブラウザで開かねばならない。
Googleの担当者にサービスについて話を聞くインタビュー特集。前回のAndroidに続き、Google Maps担当者に話を聞いた。問い合わせの多いライセンスの問題と、エンタープライズ向けのサービスに関してGoogleエンタープライズセールスの横山直人さんにお話を伺った。この2つの話題は実は密接に直結しているのである。 利用規約のFAQ Google Maps APIはシンプルで枯れているので、技術関係の質問は多くない。その代わりに多いのは、ライセンス関係だ。つまり、こういう使い方をしていいのか、という皆がグレーだと思っている領域の質問が多い。 最も多い質問は商用利用していいか、というものである。 これは基本的には「よい」。 ただし、1つだけ条件がある。誰でもアクセスできることが、許可される条件である。より具体的にいえば、有料会員制サイトや、イントラネットでの使用、独自アプリケーションで
Yahoo! Open Local Platform(YOLP)は、Yahoo!マップがデベロッパー向けに提供する地図・地域情報のAPI・SDKです。ウェブページの制作はもちろん、スマートフォン向けアプリケーションの開発においても、多彩な地図表示、店舗・施設検索、ジオコーディング、ルート検索、標高データ取得などの豊富な機能をご活用いただけます。 お知らせ 地図・地域情報の検索 Yahoo!ローカルサーチAPI 全国の店舗、イベント、クチコミ情報などの地域・拠点情報を検索できます。 Yahoo!ジオコーダAPI 住所をキーワードとして検索し、その位置情報を提供します。 Yahoo!リバースジオコーダAPI 指定の地点の住所情報を取得する機能を提供します。 その他の便利ツール 気象情報API 指定した緯度経度の降水強度実測値と予測値を取得できます。 郵便番号検索API 郵便番号を指定して、位置
こんちは。松田です。 トレイン・トレインで使用しているGoogleMapをいじっている時に座標(緯度・経度)から地名を取得する必要が出てきたので、その際に調べた逆Geocoding機能を実装したAPIをまとめてみました。 GoogleMapsAPIなど地図を使ったシステムを使用していると、住所から緯度経度などの情報を取得する方法が必要になります。これはGeocodingと呼ばれる技術で、GoogleMapsAPIではすでに公式なAPIが存在しています。 これとは逆に、ユーザーに登録させたスポットの地名を自動入力させたりする場合など、座標から地名情報を取得したい場合があります。これらは「逆Geocoding」や、「Reverse Geocoding」などと呼ばれていますが、現在のところGoogleMapsのAPIは提供されていません。 この逆Geocoding機能が使えるサービスをいくつか紹
ケータイのGPSから住所を取得(逆Geocoding)する方法 Tweet 2008/9/30 火曜日 matsui Posted in DoCoMo, 記事紹介・リンク | No Comments » アシアルさんのブログに、座標から住所を取得する方法やそのAPIをまとめた、「座標から地名を取得する逆GeocodingAPIのまとめ + サンプル」というエントリーが公開されています。 → アシアルブログ 座標から地名を取得する逆GeocodingAPIのまとめ + サンプル [blog.asial.co.jp] 住所→座標の取得は、GoogleのGeocodingという機能を使って実現できるのですが、その逆はGoogleのAPIには実装されていません。 上記エントリーでは、この逆Geocoding機能が使えるサービスをまとめて紹介しています。 またサンプルプログラムとして、「Yahooロ
ãããã«æ»ã ãã£ã¼ã ãµã¤ãº ãã£ã¼ãã®ãµã¤ãºã¯ãchs=<width in pixels>x<height in pixels> ã§æå®ãã¾ãã ãã¨ãã°ãchs=300x200 ã®å ´åã横 300ãã¯ã»ã«ã縦 200 ãã¯ã»ã«ã®ãã£ã¼ããçæããã¾ãã å°å³ä»¥å¤ã®ãã¹ã¦ã®ãã£ã¼ãã®æ大é å㯠300,000 ãã¯ã»ã«ã§ãã横ã¨ç¸¦ã®æ大å¤ã¯1000 ãã¯ã»ã«ãªã®ã§ãæå
Google Static Maps API ですが、「1ユーザあたり1日1000ユニーク画像まで」という制限があります。 Usage Limits の項目に、Use of the Google Static Maps API is subject to a query limit, of 1000 unique image requests per user per day.と書かれているわけですが、ここで書かれている "user" って、1APIキー?それとも1クライアント? どちらか疑問に思ったので、ちょっと調べてみました。 で、Google Group の質問の中に、ずばり答えがありました。 steveg The docs say "subject to a query limit, of 1000 unique image requests per user per day" -
How To Design A Good API and Why it Matters - 1:00:14 - Mar 8, 2007 Google engEDU () Rate: Google Tech Talks January 24, 2007 ABSTRACT Every day around the world, software developers spend much of their time working with a v...all » Google Tech Talks January 24, 2007 ABSTRACT Every day around the world, software developers spend much of their time working with a variety of Application Programming
Google Maps API PremierSame great maps plus a SLA, support, and control over ads Google Map API Concepts Welcome to the developer documentation for the Google Maps API! The Google Maps JavaScript API lets you embed Google Maps in your web pages. To use the API, you need to first sign up for an API key. Once you've received an API key, you can develop a map application following the instructions i
船木信宏氏とWeb APIについて語る @JTPA Posted on 7月 17, 2009. Filed under: Uncategorized | JTPA のギークサロンにて講演してきた。 「船木信宏氏とWeb APIについて語る」 – JTPA 90分の動画。 JTPA geek salon 07/10/09 09:10PM, JTPA geek salon 07/10/09 09:10PM jtpa on USTREAM. Conference PDFの資料はこちら。 Read Full Post | Make a Comment ( None so far ) Recently on using API;…
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く