===================== 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` オブジェクト .. _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` を常に含みます。 .. 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を含むかどうかに よって異なります。 `試す: `_ .. _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`