Zum Hauptinhalt springen
Integratoren mit einem Business- oder Enterprise-Plan können die Social-Media-Konten ihrer Kunden unter Sub-Profilen einbinden. Über den MCP Server erstellt ein Agent ein Sub-Profil, adressiert es und erzeugt eine Single-Sign-On-Linking-URL, die der Kunde öffnet, um seine Konten zu verbinden.

​
Ablauf

1

Sub-Profil erstellen

Rufen Sie create_profile auf (auf Konto-Ebene – ohne profileKey). Es liefert einen Profile Key für das neue Sub-Profil zurück.
2

Sub-Profil ansprechen

Verwenden Sie den zurückgegebenen Profile Key bei nachfolgenden Aufrufen – entweder über den Profile-Key-Header der Verbindung oder als pro Aufruf übergebenes profileKey-Argument. Zur Vorrangregelung siehe Verbinden & Einrichten.
3

Social-Linking-URL erzeugen

Rufen Sie generate_jwt_social_linking_url auf, um eine Single-Sign-On-Linking-URL zu erzeugen. Der JWT-Signing-Key und die Onboarding-Domain werden serverseitig abgeleitet – der Aufrufer übergibt keine X-Ayrshare-*-Header und keinen privaten Schlüssel oder Domain.
4

Kunde verknüpft seine Konten

Der Kunde öffnet die URL und autorisiert (per OAuth) seine Social-Media-Konten. Die verbundenen Konten werden mit dem Sub-Profil verknüpft.

​
Voraussetzungen

generate_jwt_social_linking_url erfordert einen profileKey. Wenn keiner ermittelt werden kann, gibt der Aufruf 400 mit der Meldung „Profile Key is required…” zurück.Für Ihr Konto muss eine Social-Linking-Domain bereitgestellt sein. Dies ist im Business- und Enterprise-Plan verfügbar.

​
Fehlerzustände

BedingungAntwort
Keine bereitgestellte Domain400 – „No social-linking domain is provisioned for this account (available on Business/Enterprise plans).”
Kein Signing-Key400 – „No signing key found for this account’s social-linking domain.”

​
Nächste Schritte

Verbinden & Einrichten

Authentifizierung und Profil-Targeting.

Tool-Katalog

Die 27 Tools nach Domäne gruppiert, mit Scope und Zweck.