Skip to main content
POST
Créez une URL de liaison sociale pour un User Profile. L’endpoint s’appelle toujours generateJWT, mais le token renvoyé est opaque et n’est pas un JWT. Consultez la Présentation de la liaison sociale pour plus de détails.
L’URL de liaison est valide pendant 5 minutes. Après 5 minutes, vous devez générer une nouvelle URL de liaison. Consultez le Max Pack expiresIn pour des options supplémentaires.
Cet endpoint est déprécié. Il est entièrement pris en charge, n’a pas de date de retrait et continue de fonctionner sans changement — il n’est simplement plus la manière recommandée de créer une URL de liaison.Le token renvoyé est une chaîne opaque commençant par ayr_ls_ : ce n’est pas un JWT décodable et il ne contient aucune charge utile lisible. Transmettez l’url à votre utilisateur telle quelle et traitez token comme un identifiant que vous stockez sans l’inspecter. Les liens que vous avez déjà créés continuent de fonctionner.POST /profiles/link-sessions réalise la même opération sans les paramètres historiques et permet en plus de consulter ou de révoquer un lien. Voir Créer une Link Session.

Paramètres d’en-tête

string
Votre clé API X (Consumer Key) provenant du portail développeur X. Alternative au paramètre de corps twitterApiKey. Lorsqu’elle est fournie, l’URL de liaison générée utilisera votre application développeur X pour la liaison OAuth.
string
Votre secret API X (Consumer Secret) provenant du portail développeur X. Alternative au paramètre de corps twitterApiSecret. Requis lorsque X-Twitter-OAuth1-Api-Key est fourni.
Recommandé : transmettez vos identifiants X via les en-têtes (X-Twitter-OAuth1-Api-Key et X-Twitter-OAuth1-Api-Secret) pour la cohérence avec tous les autres points de terminaison de l’API Ayrshare. Les paramètres de corps twitterApiKey et twitterApiSecret sont toujours pris en charge pour la rétrocompatibilité.

Paramètres du corps

string
Domaine de l’application. Veuillez utiliser le domaine exact fourni lors de l’intégration.Optionnel. S’il est omis, le domaine de votre compte est utilisé. Si vous l’envoyez, il doit s’agir d’un domaine enregistré sur votre compte.
string
obsolète
Plus utilisé. Le champ est accepté et ignoré, de sorte que les intégrations existantes continuent de fonctionner sans modification.Les URL de liaison ne sont plus signées : il n’y a donc aucune clé à envoyer. Vous pouvez supprimer ce champ et cesser de stocker la clé privée à cette fin.
string
requis
Clé de profil d’utilisateur. La clé API ne peut pas être utilisée dans ce champ.
boolean
défaut:false
Déconnecte automatiquement la session en cours. Il est recommandé de ne pas l’utiliser en production, car cela affecte les performances.Consultez Déconnexion automatique d’une session de profil pour plus d’informations.
string
Spécifiez une URL vers laquelle rediriger lorsque le bouton « Done » ou l’image du logo est cliqué. L’URL sera automatiquement raccourcie dans l’URL de liaison retournée. Redirigez la fenêtre d’ouverture d’origine en ajoutant le paramètre de requête origin=true à l’URL de redirection.
array
Spécifiez les réseaux sociaux à afficher sur la page de liaison. Cela remplacera les réseaux sociaux configurés dans la page Réseaux sociaux.
Only display Facebook, X/Twitter, LinkedIn, and TikTok
Remplacez le flux de liaison Instagram utilisé lorsqu’un utilisateur clique sur le bouton Instagram sur la page de liaison sociale pour cette URL. Valeurs valides :
  • instagram : Instagram Login direct, aucune page Facebook requise.
  • facebook : lier Instagram via une page Facebook connectée.
Force direct Instagram Login for this linking session
Lorsqu’omis, la page de liaison utilise votre paramètre Instagram Login à l’échelle du compte.Consultez Méthode de liaison Instagram pour plus d’informations.
boolean
obsolète
Plus utilisé. Le champ est accepté et ignoré.Il n’y a aucun token signé à vérifier : le token renvoyé est validé par la page de liaison lorsque votre utilisateur ouvre l’URL.
boolean
obsolète
Plus utilisé. Le champ est accepté et ignoré, car privateKey n’est plus lu.
number
défaut:5
Définissez la durée de vie du token en minutes. Plage : 1 minute à 2880 minutes.Consultez Expiration du lien pour plus d’informations.
object
Envoyez un e-mail Connect Accounts avec un lien permettant aux utilisateurs d’accéder directement à leur page de liaison sociale.Si l’e-mail ne peut pas être envoyé, vous recevez quand même le lien. La réponse contient emailSent: false et un objet emailError, afin que vous puissiez transmettre le lien à votre utilisateur autrement.Consultez E-mail Connect Accounts pour plus d’informations.
Lorsque vous incluez vos identifiants API X, l’URL de liaison générée initiera la liaison OAuth à l’aide de votre propre application développeur X. Vos utilisateurs finaux verront le nom de votre application sur l’écran de consentement X.
Obligatoire : avant d’utiliser cette fonctionnalité, vous devez ajouter ces URL de rappel aux paramètres de votre application développeur X (sous Authentication settings > Callback URI / Redirect URL) :
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
Sans elles, le flux OAuth échouera avec une erreur 403 Callback URL not approved.