Checkin

Checkinの詳細

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

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

checkinの詳細を得ます。

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

パラメータ

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

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

レスポンス

checkin	完全なcheckinオブジェクト

checkinする

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

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

場所にcheckinします。

Checkinはnotificationを常に含みます。

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

パラメータ

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

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からpublicfacebooktwitterまでの範囲です。また、publicやpublic, facebookなども可能です。デフォルトはpublicです。Shoutはprivateにはできません
ll	44.3,37.2	ユーザの場所の緯度経度。レスポンスには距離も含まれる場合があります
llAcc	10000.0	ユーザの緯度経度情報の精度をメートルで示したもの
alt	0	ユーザの高度をメートルで示したもの
altAcc	10000.0	ユーザの高度情報の精度をメートルで示したもの

レスポンス

checkin	checkinレスポンス

frinedの最近のcheckin

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

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

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

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

パラメータ

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

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

レスポンス

checkins	ユーザの詳細情報が入ったcheckinレスポンスの配列。通常venueの詳細情報も含まれますが、このcheckinがvenueを含むかどうかによって異なります。

試す:

checkinにコメントを追加する

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

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

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

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

パラメータ

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

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

レスポンス

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

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

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

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

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

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

パラメータ

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

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

レスポンス

checkin	このコメントを抜かしたcheckin