Présentation du SDK

​

SDK ou CLI

​

Prérequis

• Node.js 20 ou version ultérieure
• Un projet partenaire Social media studio
• Une clé d’API partenaire de test ou de production
• Chaque origine de votre application susceptible de recevoir un retour OAuth, enregistrée sur le projet partenaire

​

Installation

npm install @social-media-scheduler/sdk

pnpm add @social-media-scheduler/sdk

yarn add @social-media-scheduler/sdk

​

Initialiser le client

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,
});

​

Flux de bout en bout

1. Créez ou mettez à jour un utilisateur final à l’aide de l’identifiant client stable de votre base de données.
2. Créez une session de connexion de courte durée et envoyez son connectUrl au navigateur du client.
3. Une fois l’OAuth terminé, récupérez la session ou listez les connexions sociales du client.
4. Créez une publication immédiate ou programmée à l’aide d’un identifiant de connexion renvoyé.
5. Recevez les résultats de publication via des webhooks signés.

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.