generateJWT більше не єдиний спосіб створити URL для підключення. Він досі працює, і ця
сторінка досі його описує, але для нових інтеграцій використовуйте
Створення Link Session — приватний ключ не потрібен, і ви можете
перевірити, чи посилання відкривали або
відкликати його до завершення строку дії.Обидва ендпоінти використовують той самий валідатор, тож усе на цій сторінці про expiresIn,
allowedSocial, instagramLinkMethod, redirect, logout і лист Connect Accounts стосується
будь-якого з них. generateJWT зберігає три невеликі послаблення, які новіший ендпоінт
відхиляє: невідома мережа в allowedSocial, лише одна половина облікових даних X і
нерядковий redirect.Надсилання URL для підключення
Перемикання профілів
Щоб перемикатися між різними сесіями профілів (наприклад, під час тестування з кількома профілями), спочатку потрібно вийти з поточного профілю. Див. 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; цей крок більше не потрібен.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 шляхом перемикання на профіль, який хочете протестувати) у полі bodyprofileKey і натисніть синю кнопку Send.
Зразкова конфігурація досі заповнює privateKey і domain. privateKey ігнорується, а domain можна очистити, якщо ваш акаунт не має більше ніж одного домену для підключення.
Ви також можете згенерувати код із Postman.
Instagram Link Method
Акаунти Instagram можна прив’язати двома способами: безпосередньо через Instagram Login або через підключену Facebook Page. Який процес починається, коли користувач натискає кнопку Instagram на сторінці прив’язки соціальних мереж, зазвичай контролюється налаштуванням Instagram Login на рівні акаунту в панелі керування. Параметр тілаinstagramLinkMethod ендпоінту generateJWT дозволяє перевизначити це налаштування для окремого URL прив’язки:
Наприклад, якщо ваш стандарт акаунту — прив’язка через Facebook Page, наступне примусово встановить пряме входження в Instagram лише для цієї сесії прив’язки:
Instagram Link Method
- Перевизначення застосовується лише до сторінки прив’язки, відкритої з поверненого URL. Воно не змінює налаштування Instagram Login на рівні акаунту та не впливає на інші сесії прив’язки.
- Якщо
instagramLinkMethodпропущено, сторінка прив’язки використовує налаштування вашого акаунту, як і раніше. - Якщо надіслано недійсне значення, повертається помилка
400зі списком допустимих значень (instagram,facebook). - Перегляньте відмінності функцій між двома процесами перед вибором перевизначення — деякі функції Instagram, такі як пошук хештегів і колаборації, доступні лише за автентифікації через Facebook Page.
JWT Expires In
Якщо ви хочете, щоб посилання було дійсним довше стандартних 5 хвилин, додайте полеexpiresIn.
Наприклад, надішліть наступний JSON, щоб установити URL для підключення дійсним протягом 30 хвилин:
JWT Expires In
Інтеграції
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
Example Contact Email Response
Приклад Connect Accounts Email
Ось приклад електронного листа з посиланням Connect Account, що відкриває сторінку прив’язки соціальних мереж: Лист надійде з адреси:Social Connect Hub <connect@socialconnecthub.com>