Voeg publicatie toe aan je product.

Handleiding

1. 01

   Ontwerp productbevestiging vóór de API-aanroep

   Open dit onderdeel in SosoAPI

   • Selecteer in de SosoAPI-app de bedoelde werkruimte en controleer het verbonden account. Toon in je productmodel dezelfde door de gebruiker gekozen werkruimte en hetzelfde account, zonder stilzwijgend zelf te kiezen.

   • Toon het exacte bijschrift, account, lokale tijd en tijdzone in een bevestigingsstap. Laat de persoon Schedule kiezen; alleen het formulier openen mag niets indienen.

   Wat je kunt verwachten

   Een persoon kan vóór de schrijfhandeling de bestemming en het tijdstip zien. Het fictieve productmodel is een ontwerpoefening, geen geïnstalleerde klantintegratie.

2. 02

   Lees de huidige Scheduled Posts vanaf je server

   • Vervang <workspace-uuid> door je geselecteerde werkruimte-ID en voer dit leesverzoek uit op je 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.

   • Gebruik de teruggegeven gegevens om de lijst in je product te vernieuwen. Houd gebruikersbevestiging gescheiden van deze leesactie.

   Wat je kunt verwachten

   Je ontvangt de huidige werkruimteberichten of een autorisatie-/validatiefout. Dit leesverzoek maakt geen berichten.

3. 03

   Dien pas in na expliciete bevestiging van de gebruiker

   • Open Calendar en kies New Post om de beoordelingsstap met dezelfde actie in de app te vergelijken.

   • Vervang elke placeholder door toegestane IDs, een toekomstige ISO-tijdstempel met offset en een unieke idempotentiesleutel. Beoordeel account, tekst en tijdstip voordat je dit serververzoek uitvoert.

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

   • Dit verzoek plant een echt bericht in. Dien pas in na bevestiging van de gebruiker en stel de API-sleutel nooit bloot aan een browser.

   Wat je kunt verwachten

   Een geldig geaccepteerd antwoord identificeert de resulterende Scheduled Post; het bewijst niet dat een provider deze heeft gepubliceerd. Toon geweigerde bevoegdheid, ongeldig bereik/account, niet-ondersteunde inhoud of geweigerde planning als fout, niet als succes.

4. 04

   Toon de teruggegeven status en bied de gebruiker een veilige vervolgstap

   Open dit onderdeel in SosoAPI

   • Bewaar de teruggegeven Scheduled Post-ID en toon huidige status, bestemming en planning in het product.

   • Verwijs de gebruiker naar het bijbehorende Scheduled Post-detail. Verwijs bij benodigde menselijke aandacht naar het Needs Attention-item in plaats van stilzwijgend opnieuw in te dienen.

   • Markeer het verzoek pas als gepubliceerd wanneer de definitieve providerbevestigde status is vastgelegd.

   Wat je kunt verwachten

   Het product onderscheidt een verzoekontvangstbewijs van ingeplande, publicerende, gepubliceerde, mislukte en onbekende waarnemingen. Onbekende resultaten worden met het bestaande bericht afgestemd vóór een nieuwe schrijfhandeling.