Legg til publisering i produktet ditt.

Gjennomgang

1. 01

   Design produktets bekreftelse før API-kallet

   Åpne dette området i SosoAPI

   • Velg ønsket arbeidsområde i SosoAPI-appen og gjennomgå den tilkoblede kontoen. Vis det samme brukervalgte arbeidsområdet og kontoen i produktmodellen din i stedet for å velge ett i stillhet.

   • Vis nøyaktig bildetekst, konto, lokal tid og tidssone i et bekreftelsestrinn. Krev at personen velger Planlegg; åpning av skjemaet må ikke sende inn noe.

   Hva du kan forvente

   En person kan se mål og tidspunkt før skriveoperasjonen. Den fiktive produktmodellen er en designøvelse, ikke en installert kundeintegrasjon.

2. 02

   Les gjeldende planlagte innlegg fra serveren din

   • Erstatt <workspace-uuid> med valgt arbeidsområde-ID, og kjør deretter denne skrivebeskyttede forespørselen på serveren din:

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

   • Bruk returnerte data til å oppdatere produktets liste. Hold brukerbekreftelsen separat fra denne lesingen.

   Hva du kan forvente

   Du mottar arbeidsområdets gjeldende innlegg eller en autorisasjons-/valideringsfeil. Denne skrivebeskyttede forespørselen oppretter ingen innlegg.

3. 03

   Send bare inn etter uttrykkelig brukerbekreftelse

   • Åpne Kalender og velg Nytt innlegg for å sammenligne gjennomgangstrinnet med samme handling i appen.

   • Erstatt alle plassholdere med autoriserte ID-er, et fremtidig ISO-tidsstempel med forskyvning og en unik idempotensnøkkel. Gjennomgå konto, tekst og tidspunkt før du kjører denne forespørselen fra serveren.

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

   • Kjøring av forespørselen oppretter en faktisk publiseringsplan. Send bare inn etter brukerens bekreftelse, og eksponer aldri API-nøkkelen til en nettleser.

   Hva du kan forvente

   Et gyldig akseptert svar identifiserer det resulterende planlagte innlegget; det beviser ikke at leverandøren har publisert det. En nektet funksjon, ugyldig omfang/konto, ustøttet nyttelast eller avvist publiseringsplan må vises som feil, ikke rapporteres som suksess.

4. 04

   Vis den returnerte tilstanden og gi brukeren en trygg oppfølging

   Åpne dette området i SosoAPI

   • Lagre den returnerte ID-en for det planlagte innlegget og vis gjeldende tilstand, mål og publiseringsplan i produktet.

   • Lenk brukeren til detaljene for det aktuelle planlagte innlegget. Hvis levering trenger en person, lenk til elementet Krever oppfølging i stedet for å sende inn igjen i stillhet.

   • Ikke merk forespørselen som publisert før endelig leverandørbekreftet status er registrert.

   Hva du kan forvente

   Produktet skiller en forespørselskvittering fra planlagt, publiserer, publisert, mislykket og ukjente observasjoner. Ukjente resultater avstemmes mot det eksisterende innlegget før en ny skriveoperasjon.