http://developer.foursquare.com/docs/users/users.html
https://api.foursquare.com/v2/users/USER_ID
指定されたユーザのプロファイル情報を返す。これには選択されたbadgeやmayorshipも含まれます。
もしそのユーザがfriendの場合、連絡先情報、Facebook ID、Twitterハンドル名とそのユーザが最後にcheckinした場所が分かります。
さらに、pingsはこのユーザがcheckinするとping(携帯端末への通知)が送られることを示しています。この設定はsetpingsで変更できます。この設定はpingsがsettingsでfalseにされている場合には上書きされることに注意してください(このユーザがtrueにしている場合でも、pingは送信されません)
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
http://developer.foursquare.com/docs/users/search.html
https://api.foursquare.com/v2/users/search
そのユーザのfriendの検索を行います。
| HTTP メソッド | GETかPOST |
|---|---|
| 認証が必要か | YES |
特別に記載されていない限り、全てのパラメータはオプショナルです。
| phone | 91712344567,123450 | カンマ区切りの探したい電話番号 |
|---|---|---|
| foo@bar.com,alice@baz.com | カンマ区切りの探したいメールアドレス | |
| dens,sesamestreet | カンマ区切りの探したいTwitterハンドル名 | |
| twitterSource | krave | 単一のTwitterハンドル名。結果はfoursquareを使っているこのユーザのfriend |
| fbid | 123,456 | カンマ区切りの探したいFacebook ID |
| name | Fred Fredrickson | 単一の探したい人の名前 |
http://developer.foursquare.com/docs/users/requests.html
https://api.foursquare.com/v2/users/requests
そのユーザが持つ、処理待ちのfrined要求のリストを示します。(つまり、誰かがこのユーザをfrinedに加えようとしているが、このユーザが承認していない状態です)
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
特別に記載されていない限り、全てのパラメータはオプショナルです。
http://developer.foursquare.com/docs/users/badges.html
https://api.foursquare.com/v2/users/USER_ID/badges
与えられたユーザのBadge情報を返します。
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
| sets | badge ID、unlockされたbadge、badgeのunlock IDの階層構造状のgroupsが表示されます。Badgeはグループを超えて何度も出てくる可能性があります。例: unlockされたpartner badgeは”all badges”、”partner badges”、”Bravo badges”の下に出てくると思われます。 |
|---|---|
| badges | Badgeに対するbadge IDかunlockされたbadge IDの連想配列。UnlockされたBadgeはunlockした時のcheckin(クライアントが要求したときのみ返される)や基本的なBadge IDを含んでいる場合があります。 |
http://developer.foursquare.com/docs/users/checkins.html
https://api.foursquare.com/v2/users/USER_ID/checkins
認証済みユーザのCheckin履歴を返します。
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
特別に記載されていない限り、全てのパラメータはオプショナルです。
| USER_ID | self | 現在のところ”self”のみサポートしています |
|---|---|---|
| limit | 100 | レスポンスのアイテム数。最大500 |
| offset | 100 | ページを使用する場合に使います |
| afterTimestamp | 1279044824 | 最初にレスポンスを受けたときから経過したエポックタイム(1970-01-01T00:00:00Z)からの秒数。これは次のページを探すときや、変更をpollingするときに便利です。pollingの時に結果を失うことを避けるために、最後にpollした時刻から何秒か引いておき、それから重複分を削ることをお勧めします。 |
| beforeTimestamp | 1279044824 | 最初にレスポンスを受けたとき以前のエポックタイムからの秒数。ページを戻るときに便利です。 (訳注:first resultsじゃなくてlastresultsじゃないのかな) |
http://developer.foursquare.com/docs/users/friends.html
https://api.foursquare.com/v2/users/USER_ID/friends
frinedの一覧を得ます。
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
http://developer.foursquare.com/docs/users/tips.html
https://api.foursquare.com/v2/users/USER_ID/tips
ユーザのtipsを返す。
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
特別に記載されていない限り、全てのパラメータはオプショナルです。
| USER_ID | HZXXY3 | 詳細を知りたいユーザのID。現在ログインしているユーザを知りたい場合はselfを渡す |
|---|---|---|
| sort | recent | recent,nearby,popularのどれか。nearbyの場合、geolatとgeolongが必要です |
| ll | 33.7,44.2 | ユーザの緯度経度情報 |
http://developer.foursquare.com/docs/users/todos.html
https://api.foursquare.com/v2/users/USER_ID/todos
TODOを返します。
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
特別に記載されていない限り、全てのパラメータはオプショナルです。
| USER_ID | HZXXY3 | 詳細を知りたいユーザのID。現在ログインしているユーザを知りたい場合はselfを渡す |
|---|---|---|
| sort | recent | recent,popularのどちらか。nearbyの場合、geolatとgeolongが必要です(訳註: nearbyはないけど、こぴぺ失敗？) |
| ll | 33.7,44.2 | ユーザの緯度経度情報 |
http://developer.foursquare.com/docs/users/venuehistory.html
https://api.foursquare.com/v2/users/USER_ID/venuehistory
指定されたユーザが訪れた全てのVenueのリストを返します。この中には、何回訪れたか、最後に訪れたのはいつか、という情報も含まれます。
これは実験的なAPIです。私たちは技術的革新によってユーザの全てのcheckinを効率的に返せるようになったことに興奮していますが、まだ、これが正しい方法なのかどうかを検証中です。メーリングリストで意見とフィードバックをお待ちしています。
| HTTP メソッド | GET |
|---|---|
| 認証が必要か | YES |
http://developer.foursquare.com/docs/users/request.html
https://api.foursquare.com/v2/users/USER_ID/request
friend申請を別のユーザに送ります。
| HTTP メソッド | POST |
|---|---|
| 認証が必要か | YES |
http://developer.foursquare.com/docs/users/unfriend.html
https://api.foursquare.com/v2/users/USER_ID/unfriend
現在のユーザと指定されたユーザの間の全ての関係を取消します。
frinedから外し、celebrityのフォローを外し、処理待ちのfrined申請をキャンセルします。
| HTTP メソッド | POST |
|---|---|
| 認証が必要か | YES |
http://developer.foursquare.com/docs/users/approve.html
https://api.foursquare.com/v2/users/USER_ID/approve
他のユーザからの処理待ちfrined申請に対して、承認します。
| HTTP メソッド | POST |
|---|---|
| 認証が必要か | YES |
http://developer.foursquare.com/docs/users/deny.html
https://api.foursquare.com/v2/users/USER_ID/deny
他のユーザからの処理待ちfrined申請に対して、拒否します。
| HTTP メソッド | POST |
|---|---|
| 認証が必要か | YES |
http://developer.foursquare.com/docs/users/setpings.html
https://api.foursquare.com/v2/users/USER_ID/setpings
現在のユーザが指定したユーザがcheckinしたときに送られる ping (電話の通知)を受け取るかどうかを設定します。
| HTTP メソッド | POST |
|---|---|
| 認証が必要か | YES |
特別に記載されていない限り、全てのパラメータはオプショナルです。
| USER_ID | HZXXY3 | 必須設定したいユーザのID。ユーザはfriendである必要があります。 |
|---|---|---|
| value | false | 必須True か false |