Перейти до основного вмісту
Цей посібник — для налаштування однієї компанії. Для передплат Business та Enterprise Plan з кількома користувачами надається персональний посібник з інтеграції.

Підключіть свої акаунти соцмереж

Увійдіть або зареєструйте акаунт Ayrshare. На сторінці Social Account натисніть на соцмережі, які хочете підключити. Обов’язково надайте всі дозволи.

Facebook Linking Example

Отримайте свій API Key

API Key потрібен для авторизації доступу до ендпоінтів API. Цей ключ використовується у заголовку ваших запитів і має передаватися з ключовим словом Bearer. Ваш API Key знаходиться в Ayrshare Dashboard на сторінці API Key. За потреби перемкніться на свій Primary Profile на сторінці User Profiles. Далі знайдіть сторінку API Key у лівій боковій панелі. API Key Кожен виклик API має містити API Key у заголовку через Bearer Token. Також вкажіть Content-Type як application/json.
Header
Докладніше див. Authorization.

Надішліть свій перший API-пост

Публікація посту

Нижче — приклади коду, що показують, як зробити пост через наш API різними мовами програмування. Для ще простішої інтеграції ви можете скористатися одним із готових SDK-пакетів. Для публікації посту вам знадобляться:
  • Ваш API Key для автентифікації.
  • Текстовий вміст посту.
  • Платформи соцмереж, на які хочете опублікувати (включайте лише підключені платформи).
  • Опціонально: URL зображень або відео, які хочете додати.
Усі приклади використовують ендпоінт /post. Погляньмо на приклад коду:
Публікуєте в X/Twitter? X вимагає ваших власних API-облікових даних. Додайте 2 BYO-заголовки (X-Twitter-OAuth1-Api-Key та X-Twitter-OAuth1-Api-Secret) до запиту. Це одноразове налаштування для акаунта Ayrshare, і та сама пара ключів працює для кожного субпрофіля / кінцевого користувача. Деталі див. у посібнику налаштування.
Вітаємо! Ви щойно надіслали свій перший пост.

Відповідь на пост

Ви отримаєте відповідь зі status “success”, коли наш API успішно обробить ваш пост. Відповідь містить:
  • status: загальний статус виклику API (“success” або “error”)
  • errors: масив зустрічених помилок (порожній у разі успіху)
  • postIds: масив об’єктів із деталями по конкретних платформах:
    • Назва платформи
    • Post ID на цій платформі
    • URL для перегляду посту
    • Додаткова інформація для конкретної платформи
Кожна платформа в масиві postIds матиме власний статус, що дозволить вам перевірити, які платформи успішно отримали ваш пост. Перевірте свої сторінки соцмереж, щоб переконатися, що пост успішно оброблено та опубліковано. Зверніть увагу, що деякі платформи можуть мати незначну затримку до появи постів публічно. Ось приклад відповіді:
Post Response
Більше прикладів коду для виклику social media API у Node.js, Python, PHP, Golang, C# та Ruby, а також інші чудові можливості:

Post

Копнемо трохи глибше

Розберемо процес, що відбувся під час цього API-виклику.
1

Задайте заголовок

Ми задали в заголовку Authorization bearer token (API Key) та content type json.
2

Створіть об'єкт тіла

Далі створили об’єкт тіла:
  • Post з текстом “Today is a great day!”.
  • Платформи соцмереж — Facebook, Instagram та LinkedIn. Включайте лише ті платформи, які ви підключили на сторінці Social Linkage.
  • Додали зображення у mediaUrls.
3

Викличте ендпоінт /post

Надіслали все як HTTP POST на ендпоінт /post.

Перш ніж підете — кілька найкращих практик

Читайте документацію

Ми ведемо ґрунтовну та актуальну документацію. Оскільки ви вже тут, приділіть час перегляду розділів у лівій навігації.

Коди помилок важливі

Їх потрібно обробляти, щоб ваші користувачі отримали чудовий досвід.

Errors

Тримайте API Key у безпеці

Ми серйозно ставимося до безпеки — і ви теж маєте. У вас повний контроль над з’єднанням між Ayrshare та вашими акаунтами соцмереж. Після підключення акаунтів Ayrshare API Key стає способом автентифікації. Тримайте цей ключ у таємниці та безпеці.

Публікуйте тестові пости

Ви можете публікувати тестові пости з випадковою цитатою, зображенням або відео, використовуючи параметри randomPost, randomMediaUrl та isLandscapeVideo або isPortraitVideo в ендпоінті /post. Якщо використовуєте randomPost, параметр post не є обов’язковим.
Ці пости з’являються у ваших соцмережах наживо, тому за потреби видаліть їх після тестування.

Випадкова цитата

Надішліть випадкову цитату для тесту публікації, додавши randomPost: true. Використовується з ендпоінтом /post.

Випадкове зображення

Надішліть випадкове зображення, додавши randomMediaUrl: true. Використовується з ендпоінтом /post.

Випадкове відео

Надішліть випадкове горизонтальне відео, додавши isVideo: true та isLandscapeVideo: true. Відео буде стандартного горизонтального розміру. Використовується з ендпоінтом /post.
Надішліть випадкове вертикальне відео (потрібне для TikTok або Facebook/Instagram Reels), додавши isVideo: true та isPortraitVideo: true. Використовується з ендпоінтом /post.

Випадковий коментар

Надішліть випадковий коментар для тесту публікації коментаря, додавши randomComment: true. Використовується з ендпоінтом /comment.

Приклад виклику cURL

Надіслати випадкову цитату та вертикальне відео.

Використовуйте Postman для тестування API-викликів

Postman — чудовий інструмент для тестування API-викликів. Ви навіть можете генерувати код більш ніж десятьма мовами.

Демо-код

Якщо шукаєте зразок демо-проєкту на React та NodeJS, див. цей репозиторій на GitHub:

Github Social Posting Demo App

Типове усунення несправностей

Іноді щось йде не так, тож ось трохи допомоги в нашому довідковому центрі.

Troubleshooting

Звертайтеся до нас по допомогу

Ми готові допомогти — скористайтеся чатом у правому нижньому куті або напишіть нам.