Ajoutez la publication à votre produit.

Tutoriel

1. 01

   Concevoir la confirmation du produit avant l’appel API

   Ouvrir cette section dans SosoAPI

   • Dans SosoAPI, sélectionnez l’espace souhaité et vérifiez son compte connecté. Dans la maquette de votre produit, affichez ces mêmes espace et compte sélectionnés par l’utilisateur au lieu d’en choisir silencieusement.

   • Présentez la légende exacte, le compte, l’heure locale et le fuseau dans une étape de confirmation. Exigez le choix Schedule par la personne ; ouvrir le formulaire ne doit rien envoyer.

   Résultat attendu

   Une personne peut voir la cible et l’heure avant l’écriture. La maquette du produit fictif est un exercice de conception, pas une intégration client installée.

2. 02

   Lire les Scheduled Posts actuels depuis votre serveur

   • Remplacez <workspace-uuid> par l’identifiant de l’espace de travail sélectionné, puis exécutez cette requête en lecture seule sur votre serveur :

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

   • Utilisez les données renvoyées pour actualiser la liste de votre produit. Gardez la confirmation de l’utilisateur distincte de cette lecture.

   Résultat attendu

   Vous recevez les publications actuelles de l’espace de travail ou une erreur d’autorisation/de validation. Cette requête en lecture seule ne crée aucune publication.

3. 03

   Envoyer uniquement après confirmation explicite de l’utilisateur

   • Ouvrez Calendar et choisissez New Post pour comparer l’étape de validation à la même action dans l’application.

   • Remplacez chaque valeur de substitution par vos identifiants autorisés, un horodatage ISO futur avec décalage et une clé d’idempotence unique. Vérifiez le compte, le texte et l’heure avant d’exécuter cette requête côté serveur.

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

   • Cette requête crée une véritable programmation. Ne l’envoyez qu’après confirmation de l’utilisateur et n’exposez jamais la clé API à un navigateur.

   Résultat attendu

   Une réponse valide acceptée identifie le Scheduled Post créé ; elle ne prouve pas sa publication par un fournisseur. Une capacité refusée, un périmètre/compte invalide, un contenu non pris en charge ou une programmation rejetée doit apparaître comme une erreur, jamais comme une réussite.

4. 04

   Afficher l’état renvoyé et proposer un suivi sûr à l’utilisateur

   Ouvrir cette section dans SosoAPI

   • Stockez l’identifiant Scheduled Post renvoyé et affichez son état actuel, sa destination et sa programmation dans le produit.

   • Donnez à l’utilisateur un lien vers le détail du Scheduled Post correspondant. Si la diffusion nécessite une personne, liez l’élément Needs Attention au lieu de soumettre à nouveau silencieusement.

   • N’étiquetez pas la requête comme publiée avant l’enregistrement du statut final confirmé par le fournisseur.

   Résultat attendu

   Le produit distingue l’accusé de réception des observations scheduled, publishing, published, failed et unknown. Les résultats inconnus sont réconciliés avec la publication existante avant toute nouvelle écriture.