================ Tips ================ .. _tips-tips: ------------------------- Tipsの詳細 ------------------------- http://developer.foursquare.com/docs/tips/tips.html `https://api.foursquare.com/v2/tips/TIP_ID` .. Gives details about a tip, including which users (especially friends) have marked the tip to-do or done. tipsの詳細を返します。これにはユーザが(特にfriendが)TODOかDoneと付けた tipsを含みます。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - GET * - 認証が必要か - NO ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - TIP_ID - A9ABCD - 詳細を知りたいtipsのID ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - tip - :ref:`完全なtipsレスポンス` `試す: `_ .. _tips-add: ------------------------- Tipsを追加する ------------------------- http://developer.foursquare.com/docs/tips/add.html `https://api.foursquare.com/v2/tips/add` .. Allows you to add a new tip at a venue. Venueに新しいtipを追加します。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - POST * - 認証が必要か - YES ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - venueId - XXX123YYYY - **必須** tipsを追加したいvenueのID * - text - The donuts are tasty! - **必須** tipsの文字列 * - url - http://blog.zagat.com/fast-food-survey-results-are-here - このtipsに関連するURL ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - tip - 新しく追加された :ref:`tips` .. _tips-search: ------------------------- 近隣にあるTipsの検索 ------------------------- http://developer.foursquare.com/docs/tips/search.html `https://api.foursquare.com/v2/tips/search` .. Returns a list of tips near the area specified. 指定したエリアの近くにあるtipsのリストを返します。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - GET * - 認証が必要か - NO ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - ll - 44.3,37.2 - **必須** ユーザの緯度経度情報 * - limit - 100 - **オプション** レスポンスの最大数。最大500。 * - offset - 100 - **オプション** 結果を何番目から返すかを指定します * - filter - friends - もし frineds と設定してあった場合、近くにあるtipsのうちfriendsのもののみ表示します * - query - donuts - 与えた単語にマッチしたtipsのみ表示します。frinds filterと一緒に設定することはできません ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - tips - それぞれ :ref:`responses-user` と :ref:`responses-venue` を含む tipsの配列 `試す: `_ .. _tips-marktodo: ------------------------- TODOと印をつける ------------------------- http://developer.foursquare.com/docs/tips/marktodo.html `https://api.foursquare.com/v2/tips/TIP_ID/marktodo` TipsにTODOと印をつけます。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - POST * - 認証が必要か - YES ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - TIP_ID - XXX123YYYY - **必須** TODOと印をつけたいtipsのID ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - todo - 新しく付け加えられた :ref:`responses-todo` .. _tips-markdone: ------------------------- Doneと印をつける ------------------------- http://developer.foursquare.com/docs/tips/markdone.html `https://api.foursquare.com/v2/tips/TIP_ID/markdone` TipsにDoneと印をつけます。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - POST * - 認証が必要か - YES ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - TIP_ID - XXX123YYYY - **必須** Doneと印をつけたいtipsのID ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - todo - 印がつけられたtodo .. _tips-unmark: ------------------------- 印を消す ------------------------- http://developer.foursquare.com/docs/tips/unmark.html `https://api.foursquare.com/v2/tip/TIP_ID/unmark` 訳註: URLが間違っている TODOあるいはDoneのリストからtipsを取り除きます。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - POST * - 認証が必要か - YES ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - TIP_ID - XXX123YYYY - **必須** 印を取り除きたいtipsのID ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - tips - 印を取り除いたtips