Resumen del SDK

​

SDK frente a CLI

​

Requisitos

• Node.js 20 o superior
• Un proyecto de socio de Social media studio
• Una clave de API de socio de prueba o de producción
• Todos los orígenes de tu aplicación que puedan recibir un retorno de OAuth, registrados en el proyecto de socio

​

Instalación

npm install @social-media-scheduler/sdk

pnpm add @social-media-scheduler/sdk

yarn add @social-media-scheduler/sdk

​

Inicializar el cliente

import { SoMePlatformClient } from "@social-media-scheduler/sdk";

export const soMe = new SoMePlatformClient({
  apiKey: process.env.SOME_PARTNER_API_KEY!,
});

const soMe = new SoMePlatformClient({
  apiKey: process.env.SOME_PARTNER_API_KEY!,
  baseUrl: "http://localhost:8000",
  timeoutMs: 15_000,
});

​

Flujo de principio a fin

1. Crea o actualiza (upsert) un usuario final con el ID estable del cliente de tu base de datos.
2. Crea una sesión de conexión de corta duración y envía su connectUrl al navegador del cliente.
3. Cuando termine OAuth, recupera la sesión o lista las conexiones sociales del cliente.
4. Crea una publicación inmediata o programada con un ID de conexión devuelto.
5. Recibe los resultados de publicación mediante webhooks firmados.

const customer = await soMe.endUsers.upsert({
  externalId: "customer_123",
  displayName: "Acme",
});

const session = await soMe.connectSessions.create({
  endUserId: customer.id,
  platform: "THREADS",
  returnUrl: "https://app.example.com/settings/social",
});

// Redirect the customer's browser to session.connectUrl.