跳转到主要内容
在 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 頁面取得。