Añade publicación a tu producto.

Guía práctica

1. 01

   Diseña la confirmación del producto antes de la llamada API

   Abrir esta sección en SosoAPI

   • En la aplicación SosoAPI, selecciona el espacio de trabajo previsto y revisa su cuenta conectada. En el prototipo de tu producto, muestra ese mismo espacio y cuenta elegidos por el usuario en vez de seleccionarlos silenciosamente.

   • Muestra el texto exacto, la cuenta, la hora local y la zona horaria en un paso de confirmación. Exige que la persona elija Schedule; abrir el formulario no debe enviar nada.

   Qué puedes esperar

   Una persona puede ver el destino y el horario antes de la escritura. El prototipo de producto ficticio es un ejercicio de diseño, no una integración instalada de un cliente.

2. 02

   Consulta las publicaciones programadas actuales desde tu servidor

   • Sustituye <workspace-uuid> por el ID de espacio elegido y ejecuta esta solicitud de solo lectura en tu servidor:

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

   • Usa los datos devueltos para actualizar la lista de tu producto. Mantén la confirmación del usuario separada de esta lectura.

   Qué puedes esperar

   Recibes las publicaciones actuales del espacio de trabajo o un error de autorización/validación. Esta solicitud de solo lectura no crea publicaciones.

3. 03

   Envía solo tras la confirmación explícita del usuario

   • Abre Calendar y elige New Post para comparar el paso de revisión con la misma acción en la aplicación.

   • Sustituye cada marcador por tus IDs autorizados, una fecha ISO futura con desplazamiento y una clave de idempotencia única. Revisa la cuenta, el texto y la hora antes de ejecutar esta solicitud en el servidor.

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

   • Esta solicitud crea una programación real. Envíala solo tras la confirmación del usuario y nunca expongas la clave API al navegador.

   Qué puedes esperar

   Una respuesta válida de aceptación identifica la publicación programada resultante; no demuestra que el proveedor la haya publicado. Una capacidad denegada, alcance/cuenta no válidos, payload no admitido o programación rechazada deben mostrarse como error, no como éxito.

4. 04

   Muestra el estado devuelto y ofrece al usuario un siguiente paso seguro

   Abrir esta sección en SosoAPI

   • Guarda el ID devuelto de publicación programada y muestra su estado actual, destino y programación en el producto.

   • Enlaza al usuario con el detalle de la publicación programada correspondiente. Si la entrega necesita una persona, enlaza el elemento de Requiere atención en vez de reenviar silenciosamente.

   • No etiquetes la solicitud como publicada hasta registrar el estado final confirmado por el proveedor.

   Qué puedes esperar

   El producto distingue un comprobante de solicitud de las observaciones de programado, publicando, publicado, fallido y desconocido. Los resultados desconocidos se concilian con la publicación existente antes de una nueva escritura.