為您的產品加入發布功能。

操作指南

1. 01

   在 API 呼叫前設計產品確認步驟

   在 SosoAPI 中開啟此區域

   • 在 SosoAPI 應用程式中，選擇目標工作空間並審核已連結帳號。在您的產品原型中，展示使用者所選的同一工作空間和帳號，不要暗中代選。

   • 在確認步驟中顯示確切文案、帳號、本地時間和時區。要求本人選擇 Schedule；開啟表單不得提交任何內容。

   預期結果

   使用者可在寫入前看到目標和時間。虛構產品原型是設計練習，並非已安裝的客戶整合。

2. 02

   從您的伺服器讀取目前的排程貼文

   • 將 <workspace-uuid> 替換為所選 Workspace ID，再於伺服器執行此唯讀請求：

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/list",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({"workspace_id":"<workspace-uuid>"})
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • 使用回傳資料更新產品清單。使用者確認需與此讀取分開處理。

   預期結果

   您會取得 Workspace 目前貼文，或授權／驗證錯誤。此唯讀請求不會建立貼文。

3. 03

   僅在使用者明確確認後提交

   • 開啟 Calendar 並選擇 New Post，將審核步驟與應用程式中的相同操作對照。

   • 將所有預留位置替換為已授權 ID、帶偏移量的未來 ISO 時間戳及唯一冪等鍵。執行此伺服器端請求前，審核帳號、文案和時間。

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/create",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
       "workspace_id": "<workspace-uuid>",
       "social_account_id": "<threads-social-account-uuid>",
       "caption": "A small note for later: Harborlight Journal is making room for shorter daily reflections. Keep one thought; leave the rest for tomorrow.",
       "hashtags": [],
       "media": [],
       "provider_payload": {"platform": "threads", "publish_options": {"post_type": "TEXT"}},
       "scheduled_at": "<future ISO-8601 instant with offset>",
       "display_timezone": "Asia/Hong_Kong",
       "idempotency_key": "<unique-stable-key-for-this-intent>"
     })
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • 執行此請求會建立真實排程。僅在使用者確認後提交，絕不向瀏覽器暴露 API key。

   預期結果

   有效的已接受回應會指出所建立的排程貼文；不代表平台已發布。能力遭拒、範圍／帳號無效、不支援的承載內容或遭拒的排程，必須顯示為錯誤，不得回報成功。

4. 04

   呈現回傳狀態，並為使用者提供安全的後續操作

   在 SosoAPI 中開啟此區域

   • 儲存回傳的排程貼文 ID，並在產品中顯示目前狀態、目標及排程。

   • 向使用者提供對應排程貼文詳細資料的連結。如傳送需要人工處理，請連結到 Needs Attention 事項，不要暗中重新提交。

   • 在記錄平台確認的最終狀態前，不要將請求標記為已發布。

   預期結果

   產品會區分請求收據與已排程、發布中、已發布、失敗及未知的觀測結果。未知結果會先針對既有貼文核對，再進行新的寫入。