Tambahkan publikasi ke produk Anda.

Panduan langkah demi langkah

1. 01

   Rancang konfirmasi produk sebelum panggilan API

   Buka bagian ini di SosoAPI

   • Di aplikasi SosoAPI, pilih ruang kerja yang dituju dan tinjau akun terhubungnya. Dalam mockup produk Anda, tampilkan ruang kerja dan akun pilihan pengguna yang sama alih-alih memilihnya diam-diam.

   • Tampilkan caption persis, akun, waktu lokal, dan zona waktu pada langkah konfirmasi. Wajibkan orang tersebut memilih Jadwalkan; membuka formulir tidak boleh mengirim apa pun.

   Yang dapat diharapkan

   Manusia dapat melihat target dan waktu sebelum penulisan. Mockup produk fiktif adalah latihan desain, bukan integrasi pelanggan yang terpasang.

2. 02

   Baca Scheduled Posts terkini dari server Anda

   • Ganti <workspace-uuid> dengan ID ruang kerja pilihan Anda, lalu jalankan permintaan hanya baca ini di server:

   • 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.

   • Gunakan data yang dikembalikan untuk menyegarkan daftar produk Anda. Pisahkan konfirmasi pengguna dari pembacaan ini.

   Yang dapat diharapkan

   Anda menerima postingan terkini ruang kerja atau kesalahan otorisasi/validasi. Permintaan hanya baca ini tidak membuat postingan.

3. 03

   Kirim hanya setelah konfirmasi eksplisit pengguna

   • Buka Kalender dan pilih Postingan Baru untuk membandingkan langkah tinjauan dengan tindakan yang sama di aplikasi.

   • Ganti setiap placeholder dengan ID yang diizinkan, timestamp ISO mendatang dengan offset, dan kunci idempotensi unik. Tinjau akun, teks, dan waktu sebelum menjalankan permintaan sisi server ini.

   • 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.

   • Menjalankan permintaan ini membuat jadwal nyata. Kirim hanya setelah pengguna mengonfirmasi, dan jangan pernah mengekspos kunci API ke browser.

   Yang dapat diharapkan

   Respons diterima yang valid mengidentifikasi Scheduled Post yang dihasilkan; bukan bukti penyedia telah memublikasikannya. Kemampuan ditolak, cakupan/akun tidak valid, payload tidak didukung, atau jadwal ditolak harus ditampilkan sebagai kesalahan, bukan keberhasilan.

4. 04

   Tampilkan status yang dikembalikan dan berikan tindak lanjut aman kepada pengguna

   Buka bagian ini di SosoAPI

   • Simpan ID Scheduled Post yang dikembalikan dan tampilkan status terkini, tujuan, serta jadwalnya dalam produk.

   • Arahkan pengguna ke detail Scheduled Post terkait. Jika pengiriman memerlukan manusia, tautkan item Needs Attention alih-alih diam-diam mengirim ulang.

   • Jangan beri label dipublikasikan sampai status akhir yang dikonfirmasi penyedia tercatat.

   Yang dapat diharapkan

   Produk membedakan bukti penerimaan permintaan dari pengamatan terjadwal, sedang dipublikasikan, dipublikasikan, gagal, dan tidak diketahui. Hasil tidak diketahui direkonsiliasi dengan postingan yang ada sebelum penulisan baru.