Adj közzétételt a termékedhez.

Részletes útmutató

1. 01

   Az API-hívás előtt tervezd meg a termék megerősítési lépését

   A terület megnyitása a SosoAPI-ban

   • A SosoAPI alkalmazásban válaszd ki a kívánt munkaterületet, és ellenőrizd az összekapcsolt fiókját. A termékmintában ugyanezt, a felhasználó által kiválasztott munkaterületet és fiókot mutasd, ne válassz csendben másikat.

   • Megerősítési lépésben mutasd a pontos szöveget, fiókot, helyi időpontot és időzónát. A személynek kell az Időzítés lehetőséget választania; az űrlap megnyitása nem küldhet be semmit.

   Mire számíthatsz

   Írás előtt egy személy látja a célhelyet és az időpontot. A képzeletbeli termékminta tervezési gyakorlat, nem telepített ügyfélintegráció.

2. 02

   Olvasd el a jelenlegi Scheduled Posts bejegyzéseket a szerveredről

   • A <workspace-uuid> helyére a kiválasztott munkaterület-azonosítót írd, majd futtasd ezt a csak olvasási kérést a szervereden:

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

   • A visszakapott adatokkal frissítsd a termék listáját. A felhasználó megerősítése maradjon külön ettől az olvasástól.

   Mire számíthatsz

   Megkapod a munkaterület aktuális bejegyzéseit vagy egy engedélyezési/ellenőrzési hibát. Ez a csak olvasási kérés nem hoz létre bejegyzést.

3. 03

   Csak a felhasználó kifejezett megerősítése után küldd be

   • Nyisd meg a Naptárt, és válaszd az Új bejegyzés lehetőséget az ellenőrzési lépés és az alkalmazás azonos műveletének összehasonlításához.

   • Minden helyőrzőt cserélj engedélyezett azonosítóra, jövőbeli, időeltolásos ISO-időbélyegre és egyedi idempotenciakulcsra. A szerveroldali kérés futtatása előtt ellenőrizd a fiókot, szöveget és időpontot.

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

   • Ez a kérés valódi időzítést hoz létre. Csak a felhasználó megerősítése után küldd be, és soha ne tedd böngészőből elérhetővé az API-kulcsot.

   Mire számíthatsz

   Az érvényes, elfogadott válasz azonosítja a létrejött Scheduled Post bejegyzést; nem bizonyítja, hogy a szolgáltató közzétette. Megtagadott képességet, érvénytelen hatókört/fiókot, nem támogatott payloadot vagy elutasított időzítést hibaként kell mutatni, nem sikerként.

4. 04

   Jelenítsd meg a visszakapott állapotot, és adj biztonságos következő lépést a felhasználónak

   A terület megnyitása a SosoAPI-ban

   • Tárold a visszakapott Scheduled Post azonosítóját, és mutasd az aktuális állapotát, célhelyét és időzítését a termékben.

   • A megfelelő Scheduled Post részleteire irányítsd a felhasználót. Ha a kézbesítés személyt igényel, csendes újraküldés helyett a Figyelmet igényel elemre hivatkozz.

   • Ne jelöld a kérést közzétettnek, amíg a szolgáltató által megerősített végleges állapotot nem rögzítették.

   Mire számíthatsz

   A termék megkülönbözteti a kérés visszaigazolását az időzített, folyamatban lévő, közzétett, sikertelen és ismeretlen megfigyelésektől. Az ismeretlen eredményeket új írás előtt a meglévő bejegyzéssel egyezteti.