=====================
Checkin
=====================

.. _checkins-checkin:

-------------------------
Checkinの詳細
-------------------------

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

`https://api.foursquare.com/v2/checkins/CHECKIN_ID`

checkinの詳細を得ます。

.. list-table:: 
  :stub-columns: 1

  * - HTTP メソッド
    - GET
  * - 認証が必要か
    - YES

~~~~~~~~~~
パラメータ
~~~~~~~~~~

特別に記載されていない限り、全てのパラメータはオプショナルです。

.. list-table:: 
  :stub-columns: 1
  :widths: 10 10 80

  * - CHECKIN_ID
    - IHR8THISVNU
    - 追加情報を得たいcheckinのID

~~~~~~~~~~
レスポンス
~~~~~~~~~~

.. list-table:: 
  :widths: 10 90
  :stub-columns: 1

  * - checkin
    - :ref:`完全なcheckin<responses-checkin>` オブジェクト


.. _checkins-add:

-------------------------
checkinする
-------------------------

http://developer.foursquare.com/docs/checkins/add.html

`https://api.foursquare.com/v2/checkins/add`

.. Allows you to check in to a place. 

場所にcheckinします。

.. Checkins will always have notifications included.

Checkinは :ref:`notification<response-notifications>` を常に含みます。

.. list-table:: 
  :stub-columns: 1

  * - HTTP メソッド
    - POST
  * - 認証が必要か
    - YES

~~~~~~~~~~
パラメータ
~~~~~~~~~~

特別に記載されていない限り、全てのパラメータはオプショナルです。

.. list-table:: 
  :stub-columns: 1
  :widths: 10 10 80

  * - venueId
    - IHR8THISVNU
    - ユーザがcheckinしたいvenueのID。shoutの場合かvenue nameを渡す場合
      には必要ありません。veneueのIDを探すには、検索するか過去のAPIを使
      用してください。
  * - venue
    - Flight 151
    - shoutでない場合、かつ、venue IDがない場合かあるいは "venueless"
      checkinの場合、このパラメータを使ってvenueの名前を文字列として渡
      してください。これは "orphan(緯度経度はあるが住所かvenueIDがない
      状態)"となります
  * - shout
    - There are crayons! Crayons!
    - このcheckinに関するメッセージ。最大140文字までです
  * - broadcast
    - public
    - **必須** このcheckinをどの程度の範囲まで伝えるかを示します。
      `private` から `public` `facebook` `twitter` までの範囲です。また、
      `public` や `public, facebook` なども可能です。デフォルトは
      `public` です。Shoutはprivateにはできません
  * - ll
    - 44.3,37.2
    - ユーザの場所の緯度経度。レスポンスには距離も含まれる場合があります
  * - llAcc
    - 10000.0
    - ユーザの緯度経度情報の精度をメートルで示したもの
  * - alt
    - 0
    - ユーザの高度をメートルで示したもの
  * - altAcc
    - 10000.0
    - ユーザの高度情報の精度をメートルで示したもの

~~~~~~~~~~
レスポンス
~~~~~~~~~~

.. list-table:: 
  :widths: 10 90
  :stub-columns: 1

  * - checkin
    - :ref:`responses-checkin`

.. _checkins-recent:

-------------------------
frinedの最近のcheckin
-------------------------

http://developer.foursquare.com/docs/checkins/recent.html

`https://api.foursquare.com/v2/checkins/recent`

frinendが最近checkinしたリストを返します。

.. list-table:: 
  :stub-columns: 1

  * - HTTP メソッド
    - GET
  * - 認証が必要か
    - YES

~~~~~~~~~~
パラメータ
~~~~~~~~~~

特別に記載されていない限り、全てのパラメータはオプショナルです。

.. list-table:: 
  :stub-columns: 1
  :widths: 10 10 80

  * - ll
    - 44.3,37.2
    - ユーザの場所の緯度経度。レスポンスには距離も含まれる場合があります
  * - limit
    - 100
    - **オプション** レスポンスの最大数。最大500。
  * - offset
    - 100
    - **オプション** 結果を何番目から返すかを指定します
  * - afterTimestamp
    - 1279044824
    - checkinを探した時刻からの秒数。例えば、最後に取得した時からの新し
      いcheckinを探したい時に使います。もし、新しいcheckinが `limit` 以
      上あった場合、それらは無視されます。

~~~~~~~~~~
レスポンス
~~~~~~~~~~

.. list-table:: 
  :widths: 10 90
  :stub-columns: 1

  * - checkins
    - ユーザの詳細情報が入った :ref:`responses-checkin` の配列。通常
      venueの詳細情報も含まれますが、このcheckinがvenueを含むかどうかに
      よって異なります。

`試す: <http://developer.foursquare.com/docs/explore.html#req=checkins%2Frecent>`_


.. _checkins-addcomment:

------------------------------
checkinにコメントを追加する
------------------------------

http://developer.foursquare.com/docs/checkins/addcomment.html

`https://api.foursquare.com/v2/checkins/CHECKIN_ID/addcomment`

check-inにコメントを追加します。

.. list-table:: 
  :stub-columns: 1

  * - HTTP メソッド
    - POST
  * - 認証が必要か
    - YES

~~~~~~~~~~
パラメータ
~~~~~~~~~~

特別に記載されていない限り、全てのパラメータはオプショナルです。

.. list-table:: 
  :stub-columns: 1
  :widths: 10 10 80

  * - CHECKIN_ID
    - IHR8THISVNU
    - コメントを追加したいCheckin ID
  * - text
    - Awesome!
    - 追加したいコメントの文字列。最大200文字まで。

~~~~~~~~~~
レスポンス
~~~~~~~~~~

.. list-table:: 
  :widths: 10 90
  :stub-columns: 1

  * - comment
    - 最近追加されたコメント


.. _checkins-deletecomment:

--------------------------------
check-inからコメントを削除する
--------------------------------

http://developer.foursquare.com/docs/checkins/deletecomment.html

`https://api.foursquare.com/v2/checkins/CHECKIN_ID/deletecomment`

もし現在有効なユーザが、check-inの著者か所有者であれば、check-inからコ
メントを削除します。

.. list-table:: 
  :stub-columns: 1

  * - HTTP メソッド
    - POST
  * - 認証が必要か
    - YES

~~~~~~~~~~
パラメータ
~~~~~~~~~~

特別に記載されていない限り、全てのパラメータはオプショナルです。

.. list-table:: 
  :stub-columns: 1
  :widths: 10 10 80

  * - CHECKIN_ID
    - IHR8THISVNU
    - コメントを削除したいCheckin ID
  * - commentId
    - ABZQ200
    - 削除したいコメントのID

~~~~~~~~~~
レスポンス
~~~~~~~~~~

.. list-table:: 
  :widths: 10 90
  :stub-columns: 1

  * - checkin
    - このコメントを抜かした :ref:`checkin<responses-checkin>`