每月發文配額
每月發文配額限制一個個人資料在一個日曆月內可發送的發文請求(POST /post)數量。
- 每個個人資料都有自己的配額與自己的計數。Primary Profile 與每個 User Profile 會分別計算。
- 配額數量取決於你的方案。各方案的數量請參閱價格方案。
- 從 Ayrshare 儀表板發送的貼文也會計入。
配額何時重設
每月發文配額會在每個日曆月的 1 日 00:07 UTC 開始重設。可能需要幾分鐘才會套用到所有帳號。所有帳號的重設日期都相同,且不與你的帳單日期綁定。- 支付續約帳單不會重設配額。
- 變更方案會立即重設你的 Primary Profile 的計數。User Profile 的計數會保留到 1 日。
- 若你在月中訂閱,計數會從零開始。下一次重設仍是 1 日。
- 重設以 UTC 為準。在美洲,重設發生在上個月最後一天的晚上。
哪些項目計入配額
- 一個發文請求計為一次,無論它發送到多少個平台。發送到五個平台的貼文計為一次。
- 失敗的貼文也會計入。 只要 Ayrshare 嘗試發送貼文就會計入,即使部分或全部平台發送失敗。例如,社群網路拒絕了該貼文,或帳號尚未連結。
- 遭封鎖的貼文也會計入。 在某個平台上重複發生相同失敗後遭 Ayrshare 封鎖的貼文仍會計入。
- 已排程的貼文在發布時計入,而非在你排程時計入。
- 在發送前即遭拒絕的請求,例如以代碼 106 拒絕的請求。
- 在其目標的所有平台上都未通過貼文驗證的貼文。若貼文至少在一個平台上通過並已發送,就會計入。
配額用完時
當個人資料已用完其每月發文配額時:- 新的發文請求會回傳 HTTP
429與code: 106。這也包括將貼文排程到稍後發布的請求。 - 在重設前,其他貼文相關請求也會回傳
code: 106。例如取得、刪除或重試貼文,以及貼文分析。 - 到期的已排程貼文會以
code: 106失敗。它們不會在重設後自動發布。請在配額重設後重新發送。
查看用量
呼叫 User Profile 詳細資料(GET /user)。若要查看某個 User Profile,請加入其 Profile-Key 標頭。
monthlyPostCount:本月已計入的貼文數。monthlyPostQuota:每月上限。當配額為 10,000 或以上時(例如 Business 方案),會省略此欄位。上限仍然適用。monthlyApiCalls是另一個計數器,並非發文配額。
避免意外用完配額
失敗的貼文也會計入,因此不斷重試失敗貼文的迴圈,可能在沒有發布任何內容的情況下用完整個配額。- 不要自動重試會再次失敗的錯誤。請先修正原因,例如重新連結帳號。
- 只重試可能在重試後成功的錯誤,例如帶有
retryAvailable: true的錯誤,並限制重試次數。 - 定期檢查
monthlyPostCount,以便及早發現異常增加。