Підключіть свої акаунти соцмереж
Увійдіть або зареєструйте акаунт Ayrshare. На сторінці Social Account натисніть на соцмережі, які хочете підключити. Обов’язково надайте всі дозволи.
Отримайте свій API Key
API Key потрібен для авторизації доступу до ендпоінтів API. Цей ключ використовується у заголовку ваших запитів і має передаватися з ключовим словомBearer.
Ваш API Key знаходиться в Ayrshare Dashboard на сторінці API Key. За потреби перемкніться на свій Primary Profile на сторінці User Profiles.
Далі знайдіть сторінку API Key у лівій боковій панелі.

Bearer Token. Також вкажіть Content-Type як application/json.
Header
Надішліть свій перший API-пост
Публікація посту
Нижче — приклади коду, що показують, як зробити пост через наш API різними мовами програмування. Для ще простішої інтеграції ви можете скористатися одним із готових SDK-пакетів. Для публікації посту вам знадобляться:- Ваш API Key для автентифікації.
- Текстовий вміст посту.
- Платформи соцмереж, на які хочете опублікувати (включайте лише підключені платформи).
- Опціонально: URL зображень або відео, які хочете додати.
Публікуєте в 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
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.
isVideo: true та isPortraitVideo: true.
Використовується з ендпоінтом /post.
Випадковий коментар
Надішліть випадковий коментар для тесту публікації коментаря, додавшиrandomComment: true.
Використовується з ендпоінтом /comment.
