Skip to main content
Ендпоінт generateJWT створює URL для прив’язки соціальних мереж для окремого User Profile. Див. Business Plan and Launch Plan API integration для отримання додаткової інформації.
generateJWT більше не єдиний спосіб створити URL для підключення. Він досі працює, і ця сторінка досі його описує, але для нових інтеграцій використовуйте Створення Link Session — приватний ключ не потрібен, і ви можете перевірити, чи посилання відкривали або відкликати його до завершення строку дії.Обидва ендпоінти використовують той самий валідатор, тож усе на цій сторінці про expiresIn, allowedSocial, instagramLinkMethod, redirect, logout і лист Connect Accounts стосується будь-якого з них. generateJWT зберігає три невеликі послаблення, які новіший ендпоінт відхиляє: невідома мережа в allowedSocial, лише одна половина облікових даних X і нерядковий redirect.

Надсилання URL для підключення

URL для підключення авторизує вашого користувача в його профілі, тож ставтеся до нього як до пароля. Надсилайте його каналом, якому довіряєте, не записуйте в логи й не передавайте третім особам. Він залишається придатним протягом усього свого вікна, тож перезавантаження або повторна спроба OAuth працюють — але надсилайте кожне посилання лише одному користувачу і створюйте окреме посилання для кожної особи.

Перемикання профілів

Щоб перемикатися між різними сесіями профілів (наприклад, під час тестування з кількома профілями), спочатку потрібно вийти з поточного профілю. Див. Automatic Logout of a Profile Session для інструкцій щодо правильного перемикання профілів.

Profile Key

profileKey визначає, для якого User Profile призначений URL для підключення. Знайти його можна в панелі розробника Ayrshare, перейшовши до цього профілю.
Private Key більше не використовується. URL для підключення не підписуються, тож немає чого читати з файлу чи вставляти у ваш код. privateKey досі приймається й ігнорується, тому наявні інтеграції продовжують працювати, а файл private.key у вашому Integration Package можна не використовувати.

Створення URL для підключення

Однохвилинне відео про створення URL для підключення. Його записали до появи Link Sessions, тому в ньому досі показано надсилання Private Key; цей крок більше не потрібен.
URL для підключення дійсний протягом 5 хвилин. Через 5 хвилин потрібно згенерувати новий URL для підключення. Див. Max Pack expiresIn для додаткових опцій.

Відкриття URL для підключення

Відкривайте URL для підключення у новій вкладці браузера, у новому вікні браузера або у View Controller на iOS. Ви можете керувати закриттям або перенаправленням нового вікна або вкладки.
Соціальні мережі не дозволяють відкривати URL у iFrame або приховувати схвалений партнерський origin domain profile.ayrshare.com.

Перевірка URL

verify: true більше не використовується. Поле приймається й ігнорується. Немає підписаного токена для перевірки: повернутий token перевіряє сторінка підключення, коли ваш користувач відкриває URL. Раніше ця опція повторно розбирала JWT за допомогою вашого Private Key, щоб виявити пошкоджений ключ до того, як ви надішлете URL. Оскільки ключа в процесі більше немає, цей вид помилки зник.

Тестування в Postman

Рекомендується спочатку протестувати створення URL для підключення у Postman. До Integration Package, який можна знайти на сторінці API Key основного профілю в панелі, входить зразковий файл конфігурації Postman у форматі JSON. Просто імпортуйте конфігураційний файл у Postman, заповніть свій Profile Key (знайдений у панелі розробника Ayrshare шляхом перемикання на профіль, який хочете протестувати) у полі body profileKey і натисніть синю кнопку Send. Зразкова конфігурація досі заповнює privateKey і domain. privateKey ігнорується, а domain можна очистити, якщо ваш акаунт не має більше ніж одного домену для підключення. Ви також можете згенерувати код із Postman. Акаунти Instagram можна прив’язати двома способами: безпосередньо через Instagram Login або через підключену Facebook Page. Який процес починається, коли користувач натискає кнопку Instagram на сторінці прив’язки соціальних мереж, зазвичай контролюється налаштуванням Instagram Login на рівні акаунту в панелі керування. Параметр тіла instagramLinkMethod ендпоінту generateJWT дозволяє перевизначити це налаштування для окремого URL прив’язки: Наприклад, якщо ваш стандарт акаунту — прив’язка через Facebook Page, наступне примусово встановить пряме входження в Instagram лише для цієї сесії прив’язки:
Instagram Link Method
Згенерований URL для підключення включатиме перевизначення, і натискання кнопки Instagram на сторінці прив’язки запустить запитаний процес на час цієї сесії — включно через перенаправлення авторизації Instagram/Facebook. Кілька моментів, які варто знати:
  • Перевизначення застосовується лише до сторінки прив’язки, відкритої з поверненого URL. Воно не змінює налаштування Instagram Login на рівні акаунту та не впливає на інші сесії прив’язки.
  • Якщо instagramLinkMethod пропущено, сторінка прив’язки використовує налаштування вашого акаунту, як і раніше.
  • Якщо надіслано недійсне значення, повертається помилка 400 зі списком допустимих значень (instagram, facebook).
  • Перегляньте відмінності функцій між двома процесами перед вибором перевизначення — деякі функції Instagram, такі як пошук хештегів і колаборації, доступні лише за автентифікації через Facebook Page.

JWT Expires In

Якщо ви хочете, щоб посилання було дійсним довше стандартних 5 хвилин, додайте поле expiresIn. Наприклад, надішліть наступний JSON, щоб установити URL для підключення дійсним протягом 30 хвилин:
JWT Expires In
Це дозволяє надіслати посилання електронною поштою своїм користувачам, замість того щоб вони переходили до вашого застосунку або платформи. Поширений випадок використання — коли вашому користувачу потрібно повторно підключити соціальний акаунт, ви можете надіслати йому JWT-посилання електронною поштою, щоб він міг напряму повторно прив’язати соціальний акаунт, не переходячи до вашої платформи.
Обов’язково обговоріть зі своєю командою безпеки, як довго ваш бізнес хоче тримати JWT активним. Довші терміни закінчення дії створюють додатковий ризик доступу до посилання неавторизованою стороною.

Інтеграції

Bubble.io

Якщо ви користувач Bubble, будь ласка, див. Створення URL для підключення в Bubble у розділі Bubble.io для отримання інструкцій:

Bubble linking URL

Мобільний JWT

Наведені нижче приклади мобільного коду на Swift, Flutter та React Native показують, як запустити сторінку прив’язки соціальних мереж на пристрої iOS. Замініть строкову змінну jwtURL на значення, повернуте з ендпоінту /generateJWT.

Swift (iOS)

У Swift використовуйте UIViewController та SFSafariViewControllerDelegate. Ми не рекомендуємо використовувати WebView, оскільки деякі соціальні мережі, такі як Facebook і Google, блокують автентифікацію.

Flutter (Dart)

У Flutter (Dart) немає прямого еквівалента UIViewController або SFSafariViewController. Однак ви можете досягти подібної функціональності, використовуючи пакет url_launcher для відкриття веб-URL.

React Native

React Native також не має прямого еквівалента SFSafariViewController, але ви можете досягти подібного результату за допомогою API WebBrowser, наданого expo-web-browser, який відкриває URL у модальному вікні браузера, що ділиться cookies із системним браузером. Крім того, ви можете використовувати вбудовану функцію React Native Linking, щоб відкрити Safari: await Linking.canOpenURL(jwtURL);

Приклади мобільного коду

Connect Accounts Email

Разом з опцією довшого часу закінчення дії ви можете автоматично налаштувати Ayrshare, щоб вашим користувачам надсилалося посилання на сторінку прив’язки соціальних мереж електронною поштою.

Connect Accounts JSON

Наприклад, наступний JSON надішле електронний лист на john@user.com із назвою компанії ACME, контактною електронною адресою support@mycompany.com та посиланнями на умови використання та політику конфіденційності:
Example Contact Email Request
Відповідь включатиме наступне, якщо було встановлено email та час закінчення дії:
Example Contact Email Response

Приклад Connect Accounts Email

Ось приклад електронного листа з посиланням Connect Account, що відкриває сторінку прив’язки соціальних мереж: Лист надійде з адреси: Social Connect Hub <connect@socialconnecthub.com>