Zum Hauptinhalt springen
Jeder Kunde in deiner Anwendung entspricht einem isolierten Endnutzer in Social media studio. Social-Verbindungen und Beiträge sind auf diesen Endnutzer beschränkt, während dein Partner-Schlüssel für das gesamte Entwicklerprojekt gilt.

Einen Endnutzer per Upsert anlegen

Verwende als externalId eine unveränderliche Kennung aus deiner eigenen Datenbank. Ein erneuter Aufruf von upsert mit demselben Wert aktualisiert den Kunden und aktiviert ihn wieder, falls er zuvor deaktiviert war.
Speichere endUser.id zusammen mit deinem Kundendatensatz. SDK-Methoden verwenden diese Social-media-studio-ID, nicht externalId.
So verhinderst du, dass ein Kunde die eingebettete Plattform weiter nutzt:
Beim Deaktivieren wird der isolierte Workspace des Kunden deaktiviert. Ein späterer upsert mit derselben externalId aktiviert ihn wieder.

Eine Connect-Session erstellen

Connect-Sessions laufen nach 10 Minuten ab und können nur für den angegebenen Endnutzer verwendet werden. Leite den Kunden auf die zurückgegebene connectUrl weiter:
Der Origin der returnUrl muss exakt mit einem Origin übereinstimmen, der in deinem Partnerprojekt registriert ist, einschließlich Schema, Hostname und Port. Pfade und Query-Parameter dürfen abweichen. Return-URLs mit eingebetteten Zugangsdaten werden abgelehnt.

Den Abschluss behandeln

Sobald der gehostete Ablauf einen Endzustand erreicht, sieht der Kunde eine Zurück-Schaltfläche. Das Ziel erhält diese Query-Parameter: Betrachte Browser-Parameter als Benachrichtigung, nicht als Beweis für den Erfolg. Bestätige das Ergebnis über dein Backend mit der ID der Connect-Session, die du erstellt hast:
Die gehostete Seite sendet außerdem eine postMessage an ihr Opener-Fenster, wenn sie in einem Popup verwendet wird:

Konten auflisten und trennen

Übergib immer die ID des Endnutzers, dem die Verbindung gehört. Social media studio lehnt Versuche ab, eine Verbindung eines anderen Kunden zu lesen oder zu trennen.

Session-Zustände

Erstelle nach failed oder expired eine neue Session; Sessions in einem Endzustand lassen sich nicht neu starten.