Passer au contenu principal
Les intégrateurs disposant d’un Business Plan ou Enterprise Plan peuvent intégrer les comptes sociaux de leurs clients sous forme de sous-profils. À l’aide du MCP Server, un agent crée un sous-profil, le cible, et génère une URL d’association en authentification unique que le client ouvre pour connecter ses comptes.

​
Flux

1

Créer un sous-profil

Appelez create_profile (au niveau du compte — sans profileKey). Il renvoie une profile key pour le nouveau sous-profil.
2

Cibler le sous-profil

Utilisez la profile key renvoyée sur les appels suivants — soit via l’en-tête Profile-Key sur la connexion, soit comme argument profileKey par appel. Consultez Connect & Setup pour la priorité.
3

Générer une URL d'association sociale

Appelez generate_jwt_social_linking_url pour générer une URL d’association en authentification unique. La clé de signature JWT et le domaine d’onboarding sont dérivés côté serveur — l’appelant ne fournit aucun en-tête X-Ayrshare-* et aucune clé privée ni domaine.
4

Le client associe ses comptes

Le client ouvre l’URL et autorise (OAuth) ses comptes sociaux. Les comptes connectés sont associés au sous-profil.

​
Prérequis

generate_jwt_social_linking_url requiert un profileKey. Si aucun n’est résolu, l’appel renvoie 400 avec le message « Profile Key is required… ».Un domaine d’association sociale doit être provisionné pour votre compte. Cette fonctionnalité est disponible sur les Business Plan et Enterprise Plan.

​
États d’erreur

ConditionRéponse
Aucun domaine provisionné400 — « No social-linking domain is provisioned for this account (available on Business/Enterprise plans). »
Aucune clé de signature400 — « No signing key found for this account’s social-linking domain. »

​
Étapes suivantes

Connect & Setup

Authentification et ciblage de profil.

Tool Catalog

Les 27 outils regroupés par domaine, avec leur portée et leur objectif.