Skip to main content
POST
Створіть URL для підключення соцмереж для User Profile. Ендпоінт досі називається generateJWT, але повернутий токен непрозорий і не є JWT. Див. Огляд URL для підключення для отримання додаткової інформації.
URL для підключення дійсний 5 хвилин. Після 5 хвилин необхідно згенерувати новий URL для підключення. Див. Max Pack expiresIn для додаткових опцій.
Повернутий token — це непрозорий рядок, що починається з ayr_ls_: це не JWT, який можна декодувати, і він не містить читабельного payload. Передайте url вашому користувачу такою, якою її повернуто, і сприймайте token як облікові дані, які ви зберігаєте, а не аналізуєте. Посилання, створені раніше, продовжують працювати.POST /profiles/link-sessions виконує ту саму операцію без застарілих параметрів, а також дає змогу перевірити або відкликати посилання. Див. Створення Link Session.

Header Parameters

string
Ваш X API Key (Consumer Key) з X Developer Portal. Альтернатива до body-параметра twitterApiKey. Якщо вказано, згенерований URL для підключення використовуватиме ваш X Developer App для OAuth-прив’язки.
string
Ваш X API Secret (Consumer Secret) з X Developer Portal. Альтернатива до body-параметра twitterApiSecret. Обов’язково, коли надано X-Twitter-OAuth1-Api-Key.
Рекомендовано: передавайте ваші X-облікові дані через заголовки (X-Twitter-OAuth1-Api-Key і X-Twitter-OAuth1-Api-Secret) для узгодженості з усіма іншими endpoint API Ayrshare. Body-параметри twitterApiKey і twitterApiSecret все ще підтримуються для зворотної сумісності.

Body Parameters

string
Домен додатка. Використовуйте точний домен, наданий під час onboarding.Необов’язковий. Якщо не вказано, використовується власний домен вашого акаунта. Якщо ви його надсилаєте, це має бути домен, зареєстрований на ваш акаунт.
string
застаріло
Більше не використовується. Поле приймається й ігнорується, тому наявні інтеграції продовжують працювати без змін.URL для підключення більше не підписуються, тож надсилати ключ не потрібно. Ви можете вилучити це поле й припинити зберігати приватний ключ для цієї мети.
string
обов'язково
User Profile Key. API Key не можна використовувати в цьому полі.
boolean
за замовчуванням:false
Автоматично завершувати поточну сесію. Не рекомендується використовувати у продакшені, оскільки це впливає на продуктивність.Див. Automatic Logout of a Profile Session для отримання додаткової інформації.
string
Вкажіть URL для перенаправлення при натисканні кнопки “Done” або зображення логотипа. URL буде автоматично скорочено у поверненому URL для підключення. Перенаправлення вікна origin opener здійснюється додаванням query-параметра origin=true до URL перенаправлення.
array
Вкажіть, які соціальні мережі відображати на сторінці прив’язки. Це перевизначить соціальні мережі, налаштовані на сторінці Social Networks.
Only display Facebook, X/Twitter, LinkedIn, and TikTok
Перевизначити, який потік прив’язки Instagram використовується, коли користувач натискає кнопку Instagram на сторінці прив’язки для цього URL. Допустимі значення:
  • instagram: Direct Instagram Login, Facebook Page не потрібна.
  • facebook: прив’язка Instagram через підключену Facebook Page.
Force direct Instagram Login for this linking session
Якщо не вказано, сторінка прив’язки використовує ваше загальне для облікового запису налаштування Instagram Login.Див. Instagram Link Method для отримання додаткової інформації.
boolean
застаріло
Більше не використовується. Поле приймається й ігнорується.Немає підписаного токена для перевірки: повернутий token перевіряє сторінка підключення, коли ваш користувач відкриває URL.
boolean
застаріло
Більше не використовується. Поле приймається й ігнорується, оскільки privateKey більше не читається.
number
за замовчуванням:5
Встановіть тривалість дії токена в хвилинах. Діапазон: від 1 хвилини до 2880 хвилин.Див. JWT Expires In для отримання додаткової інформації.
object
за замовчуванням:5
Надіслати Connect Accounts email з посиланням, за яким користувачі можуть безпосередньо перейти до своєї сторінки прив’язки соціальних мереж.Див. Connect Accounts Email для отримання додаткової інформації.
Коли ви включаєте свої X API credentials, згенерований URL для підключення ініціюватиме OAuth-прив’язку з використанням вашого власного X Developer App. Ваші кінцеві користувачі побачать назву вашого додатка на екрані згоди X.
Обов’язково: перед використанням цієї функції ви повинні додати ці callback URL до налаштувань вашого X Developer App (у розділі Authentication settings > Callback URI / Redirect URL):
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
Без цього потік OAuth завершиться з помилкою 403 Callback URL not approved.