foursquare foursquareとは foursquare(フォースクエア)とは、Twitter、Facebook、mixi に代表されるようなソーシャルネットワークサービスの一つで、特 に自分が居る場所(位置情報)が重要な要素になるサービスです foursquareとは foursquare は現実に出かけて、たとえば喫茶店、駅などのスポ ットで iPhone、Android携帯 などで、その場所に「チェックイン( ここに居る宣言)」するというサービスです。チェックインをするたび に点数が加算されたり、同じ場所に誰よりもチェックインするとそ の場所の「メイヤー(スポットのリーダーのような存在)」に任命さ れたりとお出かけが楽しくなるサービスです。 FoursquareのAPI foursquareのAPIは下記のURLで公開されています。 foursquare API v2 ドキュメント https://developer.foursquare.com/docs/ FoursquareのAPI foursquareが提供しているAPIの種類を大きく分けると下記 のように分類できます。 API 概要 認証 OAuth2.0によるユーザ認証を行い、アクセストークンを取得する。 ユーザ ユーザ情報の取得、ユーザの検索、フレンド申請・承認などを行う。 Venue スポットの検索、取得、追加などを行う。 Tips ユーザが作成したTipsやTODOの一覧を取得する。 Checkin 指定されたスポットへのチェックインを行う。 写真 写真の詳細情報の取得や、写真の追加を行う。 設定 現在の設定の取得や、設定の変更を行う。 Multi 複数のAPIをまとめてリクエストする。 OAuth2.0 による認証 • foursquareのAPIを使用するには、OAuth2.0による認 証が必要です。 • OAuthとは OAuthは近年公開されているウェブサービス(TwitterやFacebookなど)が 取り入れている認証方式です。 パスワードをサードパーティのアプリに渡すことなくAPIを利用でき、どのリ ソースにアクセス可能かを細かくユーザーに認可させることができるため、 「サービスプロバイダも、サービスを利用するサードパーティのアプリ開発 者も、エンドユーザーも安全・安心なサービス利用が可能になる」 という 利点があります。 OAuth2.0 による認証 • OAuth2.0とは OAuth2.0ではOAuth 1.0で不評だった署名とトークン交換の複雑な仕組 みが改善されています。OAuth2.0の大きな特徴は以下の3つです。 1. 2. 3. HTTPSを必須にし、署名をなくし、トークン取得も簡略化 アクセストークンのみでリソース取得が可能に Webアプリも含め、4つのクライアントプロファイル(Webサーバ、ユーザエ イジェント、ネイティブアプリ、自立クライアント)を仕様化 OAuth2.0 による認証 • foursquareにOAuth2.0で認証する 1. アプリの登録 アプリからfoursquareを利用するには、foursquareの開発者サイト (https://ja.foursquare.com/oauth/)からアプリを登録して、OAuth認証用に必要な 情報を取得します。 OAuth2.0 による認証 • foursquareにOAuth2.0で認証する 2. アクセストークンの取得 アプリから認証ページへリダイレクトします。 https://foursquare.com/oauth2/authenticate ?client_id=YOUR_CLIENT_ID &response_type=code &redirect_uri=YOUR_REGISTERED_REDIRECT_URI もしユーザが了承したら、以下のURLにリダイレクトされるので、このリダイレクト URLをアプリ側で拾います。 https://YOUR_REGISTERED_REDIRECT_URI/?code=CODE OAuth2.0 による認証 • foursquareにOAuth2.0で認証する 2. アクセストークンの取得 アプリは以下のリクエストを生成しアクセストークンを要求します。 https://foursquare.com/oauth2/access_token ?client_id=YOUR_CLIENT_ID &client_secret=YOUR_CLIENT_SECRET &grant_type=authorization_code &redirect_uri=YOUR_REGISTERED_REDIRECT_URI &code=CODE 上記、APIの戻り値でアクセストークンを取得します。 ※以降、取得したアクセストークンを用いてfoursquareのAPIを使用します。
© Copyright 2024 ExpyDoc