Skip to main content
POST
回覆留言,也就是對留言留言。你可以使用 Ayrshare Comment ID 回覆透過 Ayrshare 發布的留言,或使用 Social Comment ID 回覆非透過 Ayrshare 發布的留言。 最常見的情境是回覆透過 Ayrshare 發布的留言;但若要回覆非透過 Ayrshare 發布的留言,可使用 Social Comment ID(從 GET /comment 端點取得)。
Facebook、Instagram 與 TikTok 只允許你回覆屬於你自己已連結帳戶或專頁之貼文上的留言。此處「非透過 Ayrshare 發布的留言」是指在你自己貼文上的留言,例如粉絲在 Instagram 應用程式中寫下的留言。在這些平台上,即使使用 Social Comment ID,你也無法回覆其他使用者貼文上的留言。在 LinkedIn 與 X 上,Ayrshare 不會檢查貼文的擁有者。能否成功回覆其他使用者貼文上的留言,取決於該網路的規則以及該貼文的回覆設定。請參閱對其他使用者的社群貼文留言。
支援平台:Bluesky、Facebook、Instagram、LinkedIn、TikTok、X 與 YouTube。

標頭參數

路徑參數

string
必填
若要回覆透過 Ayrshare 發布的留言,請使用發布留言端點回傳的 Ayrshare Comment ID commentId。例如,發布留言端點回傳的 Ayrshare comment ID commentId:
Ayrshare Comment ID Returned from POST /comment
若要回覆非透過 Ayrshare 發布的留言,請使用來自社群網路的 Social Comment ID commentId。例如,從 Facebook POST /comment 或 GET /comment 端點回傳的 social comment ID commentId:
Social Comment ID Returned from POST /comment

主體參數

array
必填
若使用 Ayrshare Comment ID 回覆透過 Ayrshare 發布的留言,請指定要張貼回覆的平台。支援平台:bluesky、facebook、instagram、linkedin、tiktok、twitter、youtube。若使用 Social Comment ID 回覆非透過 Ayrshare 發布的留言,僅需指定一個平台。支援平台:facebook、instagram、linkedin、tiktok、twitter。
string
必填
要加到該留言上的回覆內容。
array
提供圖片 URL 以附加圖片。僅支援一張圖片。僅 Facebook 與 LinkedIn。
boolean
預設值:false
若使用 Social Comment ID(即社群網路的貼文 commentId)回覆留言,請設為 true。
string
若使用 Social Comment ID 回覆 LinkedIn 留言,必須額外提供完整的 LinkedIn 留言 URN,可從 POST /comment 端點或 GET /comment 端點以 commentUrn 取得 —— 而不是僅使用 commentId。該 URN 的格式為 urn:li:comment:(urn:li:activity:<postId>,<commentId>)。 僅在 LinkedIn 且 "searchPlatformId": true 時為必填。
string
若使用 Social Comment ID 回覆 TikTok 留言,必須額外提供 TikTok 影片 ID,可從發布留言端點或取得留言端點取得。 僅在 TikTok 且 "searchPlatformId": true 時為必填。
boolean
預設值:true
以物件(Object)回應,否則以陣列(Array)回應。預設為 true。

留言中的 @提及

你可以直接在 comment 文字字串中包含 @提及。沒有另外的 mentions 參數。只需在留言文字中加入 @handle 即可。
Reply with @Mention
LinkedIn 提及: LinkedIn 的提及會由 Ayrshare 在伺服器端解析。請使用 LinkedIn 搜尋端點查詢正確的 vanity name 或 member name。組織請使用 @handle,成員請使用 @vanity_name 或 @[Full Name]。
各平台的提及語法與限制詳情請見: Reddit 不支援回覆留言。各平台的提及規則與建議請見貼文驗證。