Flickr
開發人員指南: API

立即開始使用

若要開始使用 Flickr API

  1. Request an API key, to sign your API requests.
  2. Read the Community Guidelines and the API Terms of Use.
  3. 建置、建置、建置。 測試、測試、測試。
  4. 啟動 (而如果是要讓 Flickr 社群感興趣的應用程式,請在 Flickr應用程式園地 中建立應用程式的設定檔)。

你應該瞭解的事項

API

  • 說明文件: 此處是整個 Flickr API 的說明文件。 你可以在其中找到所有可用的方法和 feeds,以及 API 開發工具詳細資訊。
  • Authentication: Flickr's auth flow is designed to ensure our users' accounts are safe. We require that users go to Flickr to authenticate a 3rd party application (such as yours), instead of allowing a possibly malicious 3rd party to handle the username/password. We make no exceptions. This approach supports all manner of applications, from websites, to mobile clients, to set-top boxes. Please carefully review the documentation to choose the flow that is most appropriate for your integration.
  • 限制:由於 Flickr API 非常容易使用,因此亦非常容易遭到濫用,這威脅到依賴 Flickr API 的所有服務。為幫助防止此現象發生,我們限制對每個 Key 的 API 的存取。如果你的應用程式在整個 Key 中每小時查詢數少於 3600(代表你整合中所有使用者的總數),你不會有問題。如果我們偵測到你的 Key 有濫用情形,將需要終止或關閉該 Key,以便他人(包括我們!)能繼續使用 Flickr API 功能。我們還會針對其他因素追蹤使用情況,以確保沒有 API 使用者濫用系統。
  • 資料安全性: 請勿將所有使用者資料 (例如認證記錄) 集中儲存在一個地方。 這樣做等於吸引駭客上門,使其可一次存取許多帳號。
  • 將 API 查詢最佳化: 比起簡單的資料查詢,搜尋和經過本地化的呼叫需要更高的運算速度,因此執行時間會較長。 此外,請留意 API 查詢中的「額外」參數可用性,這可能有助於減少你需要的呼叫數量。 請查看我們的 Code Blog 取得一些貼士,例如這篇關於標準相片回覆的文章。
  • Privacy: Every user has a default privacy setting for photos uploaded to their account. Please honor this default by either uploading with this setting or presenting it as the pre-selected option in a list of other privacy options. You can get this default via the flickr.prefs.getPrivacy API call, and please check this default daily in case the user has changed it. If your project is presenting the privacy options for a user to choose among, please use the standardized Flickr terms: Public, Friends, Family, Friends and Family, Private.
  • 短期快取: 你的應用程式可以快取最多 24 小時的 API 結果和圖片,以幫助降低 API 載入量。
  • Revoking API keys: We revoke keys for integrations that violate our API Terms of Use and our Community Guidelines. So make sure you read them carefully.
  • Using the "flic.kr" shorturl: If you'd like to use a short url for a photo, you can use the native flic.kr url shortener. The format is: flic.kr/p/[short-photo-id] where the short photo id is a base58 conversion of the photo id. You can find more info and code samples on this post of the Flickr API Group.
  • 請求 Key: 你可以在此處請求 API Key。 我們不能變更 Key 在哪個帳號下進行處理,因此請勿使用開發人員的個人帳號來申請 Key,因為一旦他們離開,你將難以控制 Flickr API Key。

最佳實務

  • 當你與使用者的相片互動或進行修改時,請讓他們知道正在進行的活動。 例如,如果你將已上載圖片加上標籤,你應該讓使用者知道。
  • 螢幕抓取 flickr.com 是不正確的行為。 API 是取得此資料的擴充方式,並且我們會定期封鎖螢幕抓取者。
  • 攝影者會使用特定長闊比來上載相片。 請遵從這些相片尺寸。 方形縮圖屬於例外情況,以便於瀏覽。
  • 連結至 Flickr 時,請連結回相片頁面,而不是包含「farm」字樣的託管網址,這不能提供有關相片的任何背景或描述資訊。

資源

我們不提供對 Flickr API 的技術支援。不過,如果你遇到問題,可以求助於以下這些資源:

新奇的小玩意兒

  • 應用程式園地:Flickr 設立了應用程式園地,用於展示透過 Flickr API 建立的應用程式。如果你想使應用程式的 API Key 納入其中,特別是如果你有上載程式(因為在相片頁面上,會將這些當作上載程式來源來呼叫),請填寫設定檔頁面。常見問題
  • Flickr Blog: 我們會在 blog.flickr.net 發表通告以及分享絕佳相片。
  • Twitter: 我們會在 twitter.com/flickr 分享快速通告,並附帶連至我們 Blog 的連結。 此帳號僅供發表通告,並且不會派人監察,因此如果你有任何疑問或意見,請直接透過我們的網站連絡我們。
  • API 發掘:在說明方法的 API 頁面的底部,我們提供了一種名為「API 發掘」的工具,你可在此處試試方法的引數,並查看傳回的結果。以下是一個範例: flickr.photos.getInfo
  • API 使用統計資料:前往你的 App Key 統計資料頁面,查看有關 Flickr API 使用的整理過的統計資料及便捷的使用情況圖表。你可以透過前往你建立的應用程式,然後按一下每個應用程式旁邊的「統計資料」連結,來找到統計資料頁面。