製品に公開機能を追加する。

手順ガイド

1. 01

   API呼び出しの前に製品の確認画面を設計する

   SosoAPIでこの画面を開く

   • SosoAPIアプリで目的のワークスペースを選び、接続アカウントを確認します。製品モックアップでも、そのユーザーが選んだワークスペースとアカウントを表示し、黙って別の対象を選ばないでください。

   • 確認手順で正確なキャプション、アカウント、現地時刻、タイムゾーンを表示します。本人がScheduleを選ぶ必要があり、フォームを開くだけで送信してはいけません。

   得られるもの

   書き込み前に人が投稿先と日時を確認できます。架空の製品モックアップは設計例であり、導入済みの顧客連携ではありません。

2. 02

   サーバーから現在のScheduled Postsを取得

   • <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キーをブラウザーに公開しないでください。

   得られるもの

   有効な受理応答はScheduled Postを識別しますが、公開の証明ではありません。権限拒否、無効範囲・アカウント、非対応内容、予約拒否は成功でなくエラーとして表示してください。

4. 04

   返された状態を表示し、安全な次の操作を案内する

   SosoAPIでこの画面を開く

   • 返されたScheduled Post IDを保存し、現在の状態、投稿先、予約を製品で表示します。

   • 該当するScheduled Postの詳細へ案内します。配信に人の対応が必要なら、黙って再送せずNeeds Attentionへ案内してください。

   • プロバイダー確認済みの最終状態が記録されるまで、公開済みと表示しないでください。

   得られるもの

   受領記録と、予約済み、公開処理中、公開済み、失敗、不明を区別します。不明な結果は新しい書き込み前に既存投稿と照合します。