Flickr API ドキュメント日本語訳 |
flickr.photos.getContactsPhotos
メソッド実行ユーザーの知り合いの中から、最近の写真一覧を取得します。
認証
このメソッドには「読み込み」権限の認証が必要です。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
count
(Optional)- 取得する写真数。既定では10が設定され、設定できる最大値は50です。
single_photo
引数が設定されていない場合に使われます。 just_friends
(Optional)- 1を設定すると、友達と家族の写真のみを表示します (ただの知り合いは除外します)。
single_photo
(Optional)- 全ての写真は年代順に表示はせず、知り合い人一人につき一つの写真(最も新しいもの)のみを取得します。
include_self
(Optional)- 1を設定すると、メソッド実行ユーザーの写真も検索対象に含めます。
extras
(Optional)- 追加で取得したい情報があれば、その情報が保存されているフィールドをコンマ区切りで設定します。現時点では、以下のフィールドをサポートしています: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update. For more information see extras under flickr.photos.search.
サーバからの応答例
<photos> <photo id="2801" owner="12037949629@N01" secret="123456" server="1" username="Eric is the best" title="grease" /> <photo id="2499" owner="33853651809@N01" secret="123456" server="1" username="cal18" title="36679_o" /> <photo id="2437" owner="12037951898@N01" secret="123456" server="1" username="georgie parker" title="phoenix9_stewart" /> </photos>
エラーコード
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
- 引数の中に、Flickrに対して有害なURLが含まれています。
API 体験
API 体験 : flickr.photos.getContactsPhotos
注意事項 |