Перейти до основного вмісту
POST
Цей endpoint дозволяє завантажити файл — зображення або невелике відео — щоб включити його у ваш пост. Буде повернуто URL зображення, яке можна використовувати в endpoint /post. Ви можете передати файл або як multipart form data як параметр форми, або як файл, закодований у Base64 як параметр тіла. Важливі примітки щодо завантаження медіа:
  1. Для найкращої продуктивності ми рекомендуємо
    • Розміщувати медіа-файли на власному сервері (наприклад, AWS S3).
    • Передавати URL медіа безпосередньо в параметрі mediaUrls endpoint /post.
    • Цей підхід швидший, ніж завантаження файлів через цей endpoint.
  2. Зберігання медіа-файлів
    • Завантажені файли зберігаються 90 днів.
    • Після 90 днів:
      • Опубліковані пости в соціальних мережах не зачіпаються.
      • Заплановані пости не буде опубліковано, якщо вони посилаються на медіа з закінченим терміном.
  3. Обмеження розміру файлу
Якщо ваші медіа вже доступні через зовнішній URL, як-от S3-бакет, ви можете пропустити завантаження файлів до Ayrshare. Просто зробіть POST на endpoint /post із вашим зовнішньо доступним URL у параметрі тіла mediaURLs, і ваш файл буде автоматично завантажено.

Параметри заголовків

Content-Type
string
обов'язково
Використовуйте multipart/form-data, якщо надсилаєте multipart form data — див. нижче. В іншому випадку надсилайте стандартний application/json.

Параметри тіла

file
string or object
обов'язково
Максимальний розмір файлу — 30 МБ.Ми рекомендуємо надсилати як multipart form-data об’єкт, а не кодуванням Base64.
fileName
string
Ім’я файлу, який буде завантажено.
description
string
Опис файлу.

Надсилання як Multipart Form-Data

Надішліть медіа-файл як об’єкт multipart form-data. Обов’язково вкажіть Content-Type, як зазначено вище.

Надсилання як Base64

Надішліть медіа-файл як рядок, закодований у Base64 як Data URI. Рядок має починатися з data:content/type;base64 Приклад кодування з форматом виводу Data URI: Примітка: endpoint /post приймає більші файли через зовнішній URL за допомогою параметра mediaUrls.