Skip to main content
POST
Crea una URL de vinculación social para un User Profile. El endpoint sigue llamándose generateJWT, pero el token que devuelve es opaco y no es un JWT. Consulta el Resumen de la vinculación social para más detalles.
La URL de vinculación es válida durante 5 minutos. Pasados 5 minutos deberás generar una nueva URL de vinculación. Consulta el expiresIn de Max Pack para opciones adicionales.
Este endpoint está deprecado. Está totalmente soportado, no tiene fecha de retirada y sigue funcionando sin cambios — simplemente ya no es la forma recomendada de crear una URL de vinculación.El token devuelto es una cadena opaca que empieza por ayr_ls_: no es un JWT decodificable y no contiene ninguna carga legible. Entregue la url a su usuario tal como se devuelve y trate token como una credencial que se almacena, no que se inspecciona. Los enlaces que creó antes siguen funcionando.POST /profiles/link-sessions realiza la misma operación sin los parámetros heredados y además permite consultar o revocar un enlace. Consulte Crear una Link Session.

Parámetros de cabecera

string
Tu X API Key (Consumer Key) del X Developer Portal. Alternativa al parámetro twitterApiKey del cuerpo. Cuando se proporciona, la URL de vinculación generada usará tu X Developer App para la vinculación mediante OAuth.
string
Tu X API Secret (Consumer Secret) del X Developer Portal. Alternativa al parámetro twitterApiSecret del cuerpo. Obligatorio cuando se proporciona X-Twitter-OAuth1-Api-Key.
Recomendado: pasa tus credenciales de X mediante cabeceras (X-Twitter-OAuth1-Api-Key y X-Twitter-OAuth1-Api-Secret) para mantener la coherencia con todos los demás endpoints de la API de Ayrshare. Los parámetros de cuerpo twitterApiKey y twitterApiSecret siguen siendo compatibles por retrocompatibilidad.

Parámetros del cuerpo

string
Dominio de la aplicación. Utiliza el dominio exacto proporcionado durante el onboarding.Opcional. Si se omite, se usa el dominio propio de su cuenta. Si lo envía, debe ser un dominio registrado en su cuenta.
string
obsoleto
Ya no se utiliza. Se acepta y se ignora, por lo que las integraciones existentes siguen funcionando sin cambios.Las URL de vinculación ya no se firman, así que no hay ninguna clave que enviar. Puede eliminar este campo y dejar de almacenar la clave privada para este fin.
string
requerido
User Profile Key. La API Key no se puede usar en este campo.
boolean
predeterminado:false
Cierra automáticamente la sesión actual. Recomendamos no usarlo en producción, ya que afecta al rendimiento.Consulta Cierre de sesión automático de una sesión de perfil para más información.
string
Especifica una URL a la que redirigir cuando se haga clic en el botón “Done” o en la imagen del logo. La URL se acortará automáticamente en la URL de vinculación devuelta. Redirige la ventana origin que abrió el enlace añadiendo el parámetro de consulta origin=true a la URL de redirección.
array
Especifica las redes sociales que se mostrarán en la página de vinculación. Esto sobrescribirá las redes sociales configuradas en la página Social Networks.
Only display Facebook, X/Twitter, LinkedIn, and TikTok
Sobrescribe el flujo de vinculación de Instagram que se usa cuando un usuario hace clic en el botón de Instagram en la página de vinculación social para esta URL. Valores válidos:
  • instagram: Instagram Login directo, no requiere Facebook Page.
  • facebook: vincula Instagram a través de una Facebook Page conectada.
Force direct Instagram Login for this linking session
Cuando se omite, la página de vinculación utiliza tu ajuste global de cuenta Instagram Login.Consulta Método de vinculación de Instagram para más información.
boolean
obsoleto
Ya no se utiliza. Se acepta y se ignora.No hay ningún token firmado que verificar: el token devuelto lo valida la página de vinculación cuando su usuario abre la URL.
boolean
obsoleto
Ya no se utiliza. Se acepta y se ignora, puesto que privateKey ya no se lee.
number
predeterminado:5
Establece la duración del token en minutos. Rango: de 1 minuto a 2880 minutos.Consulta Caducidad del enlace para más información.
object
Envía un correo Connect Accounts con un enlace para que los usuarios accedan directamente a su página de vinculación social.Si el correo no se puede enviar, igualmente recibes el enlace. La respuesta incluye emailSent: false y un objeto emailError, para que puedas enviar el enlace a tu usuario de otra forma.Consulta Connect Accounts Email para más información.
Cuando incluyes tus credenciales de la X API, la URL de vinculación generada iniciará la vinculación mediante OAuth usando tu propia X Developer App. Tus usuarios finales verán el nombre de tu app en la pantalla de consentimiento de X.
Obligatorio: antes de usar esta funcionalidad, debes añadir estas URL de callback a los ajustes de tu X Developer App (en Authentication settings > Callback URI / Redirect URL):
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
Sin ellas, el flujo OAuth fallará con un error 403 Callback URL not approved.