Flickr API ドキュメント日本語訳 |
flickr.groups.browse
グループとサブカテゴリーを検索し、グループカテゴリをツリー構造で表示します。
認証
このメソッドには「読み込み」権限の認証が必要です。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
cat_id
(Optional)- グループとサブカテゴリーの一覧を取得するために使うカテゴリーID。 指定されていない場合、既定では0が設定され、ツリー構造の最上部にあるカテゴリーが取得されます。
サーバからの応答例
<category name="Alt" path="/Alt" pathids="/63"> <subcat id="80" name="18+" count="0" /> <subcat id="82" name="Absurd" count="4" /> <group nsid="34955637532@N01" name="Cal's Public Test Group" members="13" online="1" chatnsid="34955637533@N01" inchat="0" /> <group nsid="34158032587@N01" name="Eric's Alt Group Test" members="3" online="0" chatnsid="34158032588@N01" inchat="0" /> </category>
subcat
エレメントのcount
属性は、subcat内のグループの数を表します。
group
エレメントのmembers
属性は、グループ内のメンバーの総数を表します。online
属性は、現在オンライン状態のメンバーの数を表します。
inchat
属性は、グループ内でチャットしている人の数を表します。その人がグループのメンバーかどうかは考慮しません。
エラーコード
1: Category not found
- cat_id に指定された値は、有効なカテゴリーIDではありません。
95: SSL is required
- Flickr APIにはSSLでの接続が必要です。
96: Invalid signature
- 送信された署名は無効です。
97: Missing signature
- 実行には署名が必要ですが、署名が送信されていませんでした。
98: Login failed / Invalid auth token
- 送信されたログイン情報や認証トークンが無効です。
99: User not logged in / Insufficient permissions
- このメソッドの実行にはユーザー認証が必要ですが、ユーザがログインしていないか、認証メソッドを実行するのに必要な権限がありません。
100: Invalid API Key
- 送信されたAPIキーは無効か、既に失効しています。
105: Service currently unavailable
- 要求されたサービスは、一時的に利用できない状態です。
106: Write operation failed
- 要求された操作は、一時的な問題のために失敗しました。
111: Format "xxx" not found
- 要求された応答形式は見つかりませんでした。
112: Method "xxx" not found
- 要求されたメソッドは見つかりませんでした。
114: Invalid SOAP envelope
- リクエスト時に送信されたSOAPエンベロープを解析できませんでした。
115: Invalid XML-RPC Method Call
- リクエスト時に送信されたXML-RPC ドキュメントを解析できませんでした。
116: Bad URL found
API 体験
注意事項 |