为你的产品加入发布功能。

操作指南

1. 01

   在 API 调用前设计产品确认步骤

   在 SosoAPI 中打开此区域

   • 在 SosoAPI 应用中，选择目标工作区并审核已连接账号。在你的产品原型中，展示用户所选的同一工作区和账号，不要暗中代选。

   • 在确认步骤中显示确切文案、账号、当地时间和时区。要求当事人选择 Schedule；打开表单不得提交任何内容。

   预期结果

   用户可在写入前看到目标和时间。虚构产品原型是设计练习，并非已安装的客户集成。

2. 02

   从你的服务器读取当前的排程帖子

   • 将 <workspace-uuid> 替换为所选 工作区 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.

   • 使用返回资料更新产品清单。用户确认需与此读取分开处理。

   预期结果

   你会获取 工作区 当前帖子，或授权／验证错误。此唯读请求不会创建帖子。

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，并在产品中显示当前状态、目标及排程。

   • 向用户提供对应 Scheduled Post 详情的链接。如交付需要人工处理，请链接到 Needs Attention 事项，不要暗中重新提交。

   • 在记录平台确认的最终状态前，不要将请求标记为已发布。

   预期结果

   产品会区分请求收据与已排程、发布中、已发布、失败及未知的观测结果。未知结果会先针对现有帖子核对，再进行新的写入。