這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:4月25日
中文(香港) 更新時間:3月5日

總覽

Instagram 基本顯示 API 是 HTTP 基礎的 API,應用程式可用其來取得 Instagram 用戶的個人檔案、圖像、影片和相簿。

自 2023 年 10 月 27 日起,如果您的應用程式需要基本顯示 API 的進階存取權限,您可能需要完成資料處理問題。詳情請參閱此部落格文章常見問題

自 9 月 5 日起,部分開發人員可能也需要在年度資料使用情形檢查時回答資料處理問題。

不公開 Instagram 帳戶的長期存取憑證現在可以重新整理。另外,擁有不公開帳戶的應用程式用戶向應用程式所授予的權限有效期現為 90 日。

元件

基本網址

  • api.instagram.com - 用於取得 Instagram 用戶存取權杖
  • graph.instagram.com – 用於取得 Instagram 用戶個人檔案和影音內容

版本

API 支援的版本協定和發佈週期與 Facebook 圖形 API 支援的相同。新版本大約每 3 個月發佈一次,每個版本在停用前大約可使用 2 年。

若要查詢特定 API 版本,請將版本編號加在基本網址後的查詢路徑中。例如:

https://graph.instagram.com/v11.0/10218560180051171/media

如果在要求中省略版本編號,該要求將解析到應用程式主控板 > 設定 > 進階 > 升級 API 版本區塊中所指定的版本。

授權視窗

授權視窗可讓您的應用程式向應用程式用戶取得授權碼權限。授權碼可換成 Instagram 用戶存取權杖,其在查詢應用程式用戶的個人檔案或其影音內容時必須加入。

若要實作授權視窗,請參閱我們的取得存取權杖指南。

授權碼

授權碼可換成短期 Instagram 用戶存取權杖。若要取得授權碼,請將授權視窗實作到您的應用程式。應用程式用戶透過視窗完成身分驗證並為您的應用程式授予需要的任何權限後,我們會將用戶重新導向至您的應用程式並加入授權碼。接著您可用 API 將代碼換成應用程式用戶的短期 Instagram 用戶存取權杖

授權碼屬於短期代碼,有效時間僅 1 小時

Instagram 用戶存取權杖

API 驗證由符合 OAuth 2.0 通訊協定的 Instagram 用戶存取權杖處理。存取權杖屬於應用程式範圍(專屬於應用程式和用戶對組),可為短期權杖或長期權杖。查詢 Instagram 用戶或其影音內容的 API 要求必須包含 Instagram 用戶存取權杖。

短期存取權杖

短期存取權杖的有效時間為 1 小時,但可換成長期權杖。若要取得短期存取權杖,請將授權視窗實作到您的應用程式。應用程式用戶透過視窗完成身分驗證後,我們會將用戶重新導回至您的應用程式並加入授權碼,然後您可將代碼換成短期存取權杖。

長期存取權杖

尚未失效的短期權杖可換成長期存取權杖,其有效期為 60 天。長期權杖可在失效前透過查詢 GET /refresh_access_token 端點來重新整理

權限

資料存取授權由應用程式用戶透過使用下列權限控制。用戶必須透過授權視窗授予應用程式這些權限,應用程式才能存取其資料。

Instagram 測試員可以隨時授予應用程式上述權限。為了讓不具應用程式角色的應用程式用戶能夠授予應用程式上述權限,每個權限必須先經由應用程式審查流程獲得進階存取核准,且應用程式必須處於上線模式

擁有公開帳號之應用程式用戶授予的權限有效期為 90 天。如果授予權杖的應用程式用戶擁有公開帳號,重新整理應用程式用戶的長期存取權杖可將授予的權限再延長 90 天。但是,如果應用程式用戶的帳號是私密的,授予的權限將無法延長,應用程式用戶必須再次授予應用程式過期的權限。

Instagram 測試員

為了與 Instagram 用戶一起測試您的應用程式,您必須先向 Instagram 用戶的帳號發送邀請並接受邀請。您可以從應用程式主控板 > 角色 > 角色頁籤中的 Instagram 測試員區塊發送邀請。

Instagram 用戶登入自己的帳號後,可以在 Instagram 網站或行動應用程式的(個人檔案圖示)> 編輯個人檔案 > 應用程式和網站 > 測試員邀請區塊接受邀請。

相關資源

API 中的資料包含 Instagram 用戶和其影音內容(圖像、影片和相簿)。所有資料皆受權限保護;若要讓您的應用程式存取用戶資料,用戶必須透過授權視窗授予應用程式存取權限。

用戶

Instagram 用戶和其個人檔案由用戶節點代表。請注意,Instagram 舊版 API 用戶編號與 Instagram 基本顯示 API 不相容。

影音素材

圖像、影片和相簿由影音素材節點代表,在個別的用戶上建立。

速率限制

所有端點要求皆受圖形 API 平台限速的限制。

Instagram 產品加入應用程式後,您可在應用程式主控板 > Instagram > 基本顯示限速頁籤中查看應用程式目前耗用的呼叫次數。

應用程式類型

不支援指定為企業應用程式的應用程式。如果您的應用程式為企業應用程式,請改用 Instagram 圖形 API,或建立新的非企業應用程式。

應用程式審查

Instagram 測試員可以隨時授予應用程式 Instagram 權限。為了讓不具應用程式角色的應用程式用戶能夠授予應用程式 Instagram 權限,每個權限必須先經由應用程式審查流程獲得進階存取核准,且應用程式必須處於上線模式

完成應用程式開發且準備好將應用程式切換為上線模式後,請檢閱我們的應用程式審查、提交範例常見遭拒原因文件,以瞭解應用程式審查的流程。熟悉流程後,您可透過應用程式主控板 > 產品 > Instagram > 基本顯示頁籤要求核准 Instagram 基本顯示 API 權限。

如果您只是為了使用用戶權杖產生器產生存取權杖才建立應用程式,則無需提交應用程式進行應用程式審查。用戶權杖產生器不需任何權限,可在應用程式處於開發模式時使用。

商家驗證

當應用程式處於開發模式時,只能存取 Instagram 測試員帳號中的資料。您必須先完成商家驗證,才能將應用程式切換為上線模式並存取非測試員帳號的資料。

運作方式

若要使用 API,請先取得授權視窗並向應用程式用戶顯示。應用程式用戶將透過視窗進行身分驗證,然後授予應用程式專屬權限,授權應用程式存取其資料。完成授權後,視窗會重新導回至您的應用程式並加入授權碼。請擷取該代碼,將其換成短期 Instagram 用戶存取權杖。取得短期權杖後,您可用其來查詢用戶影音素材端點,以取得用戶允許應用程式存取的任何資料,或將其換成長期權杖

工具

用戶權杖產生器

Instagram 用戶權杖產生器是一種工具,可用來快速產生適用於任何公開 Instagram 帳號的長期 Instagram 用戶存取權杖。如果您正對應用程式進行測試且不想費心建置授權視窗,或者如果您正使用第三方服務(例如,在您的網站上顯示自己的 Instagram 資料)所提供的複製和可貼上程式碼,則此功能非常有用。

該工具是透過觸發授權視窗來運作,您可以使用已指定為測試員帳號的公開 Instagram 帳號登入。登入後,該工具會產生長期存取權杖,您可以複製和貼上該權杖。請注意,您只能產生適用於公開 Instagram 帳號的權杖。

權杖屬於可攜式!也就是說,擁有權杖的任何人都可以使用我們的 API,從用來產生該權杖的 Instagram 測試員帳號提取資料。因此,您應該只與可靠的第三方服務分享權杖。我們不鼓勵您使用要求提供權杖的第三方服務;反之,服務應為您提供包含權杖預留位置的複製和可貼上程式碼,您可以手動進行替換。

您可以在應用程式主控板 > 產品 > Instagram > 基本顯示頁籤中使用權杖產生器。

如果您只是為了使用用戶權杖產生器產生存取權杖才建立應用程式,則無需提交應用程式進行應用程式審查。用戶權杖產生器不需任何權限,可在應用程式處於開發模式時使用。

後續步驟

請依照我們的新手指南操作,以瞭解如何設定應用程式及執行基本的 API 要求。