Skip to main content
在 API 呼叫中指定 User Profile 的方式,是在標頭中加入 Profile Key
User Profile 是 Ayrshare 的核心概念之一,讓你能建立與管理多個使用者。你平台上的每一位使用者,都會擁有一個或多個 Ayrshare User Profile。每個 User Profile 對每個支援的社群網路都可以有一個連線。

Profile Key

許多端點(例如 /user、/analytics 或 /delete)都可以透過在標頭中加入「Profile-Key」參數來代表某個 Profile 帳號執行。 舉例來說,/delete 端點可搭配指定的 Profile Key,用來刪除該 Profile 帳號中指定 post id 的貼文。

啟用或停用社群網路

你可以在全域層級或 User Profile 層級啟用與停用社群網路。 需要注意的是,透過控制台在全域設定中停用的社群網路,會覆蓋 User Profile 的設定。 例如,若你在控制台中停用了 TikTok 存取權限,那麼所有 User Profile 都無法使用 TikTok。反之,若你在控制台中啟用 TikTok,但針對某個特定 User Profile 停用它,則除了該特定 Profile 外,所有 User Profile 都能存取 TikTok。

取得已連結的社群帳號

使用 /profiles 端點/user 端點,取得 User Profile 已連結的社群帳號。

對某個 User Profile 發文

使用 /post 端點,你可以在標頭中加入 Profile Key,對指定的 User Profile 發文。回應會是一個貼文結果或錯誤結果的陣列,並帶有整體狀態:若所有貼文都成功,狀態為「success」;若任何一則失敗,狀態為「error」。 你可以在使用 /create-profile 端點建立 Profile 時取得使用者的 Profile Key,或於 Ayrshare 網頁控制台 GUI 中切換到該 Profile,並前往 Profile Key 頁面取得。

Demo User Profiles

Demo User Profile 讓你可以為潛在的終端使用者提供為期 30 天的試用,體驗你平台的社群功能,而不必立即將其轉為標準的 User Profile。 建立 Profile 時設定 demo: true 即可建立。Demo User Profile 的運作方式與標準 User Profile 完全相同 —— 你的使用者可以使用其 Profile Key 連結社群帳號、發文並取得分析資料。 30 天後,Demo User Profile 會自動轉換為標準的 User Profile。若你已註冊 demo webhook,則會在轉換發生前兩天收到 upgradeWarning 事件,並在轉換發生時收到 upgrade 事件,讓你可以事先提醒使用者(或移除該 Profile)。
Demo User Profile 僅在 Enterprise plan 下提供,且必須為你的帳號啟用。如需進一步了解,請聯絡我們