===============
エンドポイント
===============

http://developer.foursquare.com/docs/index_docs.html

.. The foursquare APIv2 provides methods for accessing a resource such
   as a venue, tip, or user, at a canonical URL. For example,
   information about Clinton Street Baking Co can be found at

foursquare APIv2はvenue、tip、あるいはユーザといった** リソース** にア
クセスするには、伝統的なURLを使用します。例えば、 `Clinton Street
Baking Co <http://foursquare.com/venues/5104>`_ に関する情報は以下のよ
うにして得られます。

`https://api.foursquare.com/v2/venues/5104?oauth_token=XXX.`

.. Given a resource, you can then drill into a particular aspect, for
   example
   https://api.foursquare.com/v2/venues/5104/tips?oauth_token=XXX. Each
   returned tip will have its own ID, which corresponds to a resource
   URL, for example
   https://api.foursquare.com/v2/tips/1552606?oauth_token=XXX.

リソースが与えられると、あたなはそれに関する **アスペクト** を得ること
が出来ます。例えば次のようにです。
`https://api.foursquare.com/v2/venues/5104/tips?oauth_token=XXX`

それぞれに返されるtipはリソースのURLに対応するそれぞれのIDを持ちます。例: 

`https://api.foursquare.com/v2/tips/1552606?oauth_token=XXX.`

.. A given resource also has a series of actions associated with
  it. For example, by calling
  https://api.foursquare.com/v2/users/1/friend with POST and an
  oauth_token, you can add this user as a friend.

与えられたリソースは、対応する一連の **アクション** も持ちます。例えば、
`https://api.foursquare.com/v2/users/1/friend` にPOSTメソッドと
oauth_tokenでアクセスした場合、このユーザをfriendとして追加できます。

.. toctree::
  :maxdepth: 1

  users
  venues
  tips
  checkins
  photos
  settings
  multi
  responses



.. list-table:: 
   :header-rows: 1

   * - 
     - General
     - アスペクト
     - アクション
   * - :ref:`users-user` 
     - :ref:`users-search` /
       :ref:`users-request`
     - :ref:`users-badges` / 
       :ref:`users-checkins` / 
       :ref:`users-friends` / 
       :ref:`users-tips` /
       :ref:`users-todos` /
       :ref:`users-venuehistory`
     - :ref:`users-request` / 
       :ref:`users-unfriend` /
       :ref:`users-approve` / 
       :ref:`users-deny` / 
       :ref:`users-setpings`
   * - :ref:`venues-venues`
     - :ref:`venues-add` / 
       :ref:`venues-categories` / 
       :ref:`venues-search`
     - :ref:`venues-herenow` / 
       :ref:`venues-tips` 
     - :ref:`venues-marktodo` /
       :ref:`venues-flag` /
       :ref:`venues-proposeedit` 
   * - :ref:`tips-tips`
     - :ref:`tips-add` / 
       :ref:`tips-search`
     - 
     - :ref:`tips-marktodo` / 
       :ref:`tips-markdone` / 
       :ref:`tips-unmark`
   * - :ref:`checkins-checkin` / 
     - :ref:`checkins-add` / 
       :ref:`checkins-recent`
     -  
     - :ref:`checkins-addcomment` /
       :ref:`checkins-deletecomment`
   * - :ref:`photos-photo`
     - :ref:`photos-add`
     - 
     - 
   * - 設定
     - :ref:`settings-all`
     - 
     - :ref:`settings-set`

追加のエンドポイント

.. list-table:: 

   * - :ref:`/v2/multi<multi-multi>`
     - 複数のリクエストを一つにまとめます