explore.getHotTags

explore.getHotTags

オリジナル: http://wiki.lingr.com/dev/show/ExploreHotTags

翻訳日: 2007/04/13

原文ビジョン: 3


現在のhot tags一覧を取得します。1分に1回以上ポーリングしてはいけません。

HTTPメソッド

GET

パラメータ

api_key(必須)

あなたのAPIキー

count(オプション)

何件取得するか。デフォルトは10で、最大は500まで指定できます。

format(オプション)

希望の応答フォーマット。指定する場合はxmljsonを指定します。デフォルトxmlです。

callback(オプション)

応答フォーマットjsonを指定した場合、コールバック関数名を指定します。


認証

このメソッドは認証を必要としません。

応答の例

<?xml version='1.0' encoding='UTF-8'?>
<response>
  <status>ok</status>
  <tags>
    <tag>
      <name>sanfrancisco</name>
      <display_name>San Francisco</display_name>
      <url>http://www.lingr.com/tag/sanfrancisco</url>
      <rank>4</rank>
    </tag>
    <tag>
      <name>food</name>
      <display_name>Food</display_name>
      <url>http://www.lingr.com/tag/food</url>
      <rank>7</rank>
    </tag>
  </tags>
</response>

応答の詳細

成功したメソッド呼び出しの応答は以下のような要素を持ちます。

tags

タグを格納した配列です。それぞれのタグの構造は次のページを参照してください。→Tag

エラーコード

100: 不正HTTPメソッド

HTTPメソッドが間違っています。

101: 無効なAPIキー

指定されたAPIキーが不正です。

104: 不正な応答フォーマット

要求された応答フォーマットサポートされていません。

112: 回数制限に達した

ポーリングの頻度が制限以上です。

120: 不正文字コードエンコーディング

あなたが入力したデータUTF-8として不正エンコーディングを含んでいます。

詳細は「APIの基礎について学ぶ」を参照してください。