Veröffentlichung in dein Produkt integrieren.

Anleitung

1. 01

   Produktbestätigung vor dem API-Aufruf gestalten

   Diesen Bereich in SosoAPI öffnen

   • Wähle in der SosoAPI-App den gewünschten Workspace und prüfe das verbundene Konto. Zeige in deinem Produktmockup denselben vom Nutzer gewählten Workspace und dasselbe Konto, statt stillschweigend eines auszuwählen.

   • Zeige genauen Text, Konto, Ortszeit und Zeitzone in einem Bestätigungsschritt. Die Person muss „Planen“ wählen; das Öffnen des Formulars darf nichts einreichen.

   Was dich erwartet

   Ein Mensch kann Ziel und Zeitpunkt vor dem Schreibvorgang sehen. Das fiktive Produktmockup ist eine Designübung, keine installierte Kundenintegration.

2. 02

   Aktuelle Scheduled Posts von deinem Server lesen

   • Ersetze <workspace-uuid> durch deine Workspace-ID und führe diese reine Leseanfrage auf deinem Server aus:

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

   • Aktualisiere mit den zurückgegebenen Daten die Produktliste. Halte Nutzerbestätigung von diesem Lesezugriff getrennt.

   Was dich erwartet

   Du erhältst aktuelle Workspace-Beiträge oder einen Autorisierungs-/Validierungsfehler. Diese reine Leseanfrage erstellt keine Beiträge.

3. 03

   Erst nach ausdrücklicher Nutzerbestätigung einreichen

   • Öffne den Kalender und wähle „Neuer Beitrag“, um den Prüfschritt mit derselben Aktion in der App zu vergleichen.

   • Ersetze jeden Platzhalter durch autorisierte IDs, einen zukünftigen ISO-Zeitstempel mit Offset und einen eindeutigen Idempotenzschlüssel. Prüfe Konto, Text und Zeitpunkt vor dieser serverseitigen Anfrage.

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

   • Diese Anfrage erstellt einen echten Zeitplan. Reiche sie erst nach Nutzerbestätigung ein und gib den API-Schlüssel niemals an einen Browser weiter.

   Was dich erwartet

   Eine gültige angenommene Antwort identifiziert den erzeugten Scheduled Post; sie beweist keine Anbieterveröffentlichung. Verweigerte Funktionen, ungültiger Umfang/Konto, nicht unterstützter Payload oder abgelehnter Zeitplan müssen als Fehler statt als Erfolg erscheinen.

4. 04

   Zeige den zurückgegebenen Zustand und biete einen sicheren nächsten Schritt

   Diesen Bereich in SosoAPI öffnen

   • Speichere die zurückgegebene Scheduled-Post-ID und zeige aktuellen Zustand, Ziel und Zeitplan im Produkt.

   • Verlinke den Nutzer zu passenden Scheduled-Post-Details. Benötigt die Zustellung einen Menschen, verlinke den Eintrag mit Handlungsbedarf, statt stillschweigend erneut einzureichen.

   • Bezeichne die Anfrage erst als veröffentlicht, wenn der endgültige anbieterbestätigte Status erfasst ist.

   Was dich erwartet

   Das Produkt unterscheidet Anfragebelege von Beobachtungen als scheduled, publishing, published, failed und unknown. Unbekannte Ergebnisse werden vor neuem Schreiben mit dem bestehenden Beitrag abgeglichen.