Перейти до основного вмісту
GET
Для завантаження файлів розміром понад 10 МБ отримайте попередньо підписаний URL для завантаження файлу.
  • Максимальний розмір завантажуваного файлу — 5 ГБ.
  • Попередньо підписаний URL для завантаження дійсний протягом 30 хвилин після створення.
  • URL доступу доступний протягом 30 днів після завантаження. Усі опубліковані дописи не зазнають впливу у соціальних мережах. Заплановані дописи поза цим часовим інтервалом призведуть до помилок під час публікації.
Якщо ваші медіа вже доступні за зовнішнім URL, як-от у S3-бакеті, ви можете пропустити завантаження файлів до Ayrshare. Просто зробіть POST-запит до ендпоінту /post з вашим зовнішньо доступним URL у параметрі тіла mediaURLs, і ваш файл буде автоматично завантажено.

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

Параметри запиту

fileName
string
Якщо contentType відсутній, потрібне повне ім’я файлу з розширенням.Ім’я файлу для завантаження. Має містити розширення, як-от .png, .jpg, .mov, .mp4 тощо.
contentType
string
Content-type медіа, що завантажується. Дійсні формати: mp4, mov, png, jpg або jpeg.Наприклад, якщо файл — це файл Quicktime .mov, то contentType має бути mov.Якщо не вказано, буде використано application/octet-stream.

Деталі відповіді

  • accessUrl — URL для доступу до медіафайлу після завантаження.
  • contentType — content-type, встановлений для медіа, що завантажується. Використовуйте його в заголовку Content-Type під час завантаження медіа.
  • uploadUrl — URL, який використовується для PUT медіафайлу. Див. нижче.

Додаткові приклади ендпоінтів

Процес завантаження великих файлів:
  • Отримайте uploadURL та accessURL через ендпоінт /media/uploadUrl. Див. вище.
  • Завантажте файл через PUT з Content-Type, встановленим у повернутий contentType.
  • Завантажте медіа за допомогою --upload-file з медіафайлом та uploadUrl.
  • При успішному завантаженні буде повернуто відповідь 200.
  • Після завантаження медіафайлу зробіть POST-запит до ендпоінту /post з accessUrl у параметрі тіла mediaUrls.
  • Попередньо підписаний URL для завантаження можна використати лише один раз. Якщо ви надіслали неправильний файл, ви маєте створити новий URL для завантаження. Відповідь про помилку не з’явиться, якщо файл не було успішно завантажено. Див. нижче про перевірку існування URL.
Будь ласка, переконайтеся, що contentType, встановлений під час створення uploadUrl, відповідає Content-Type і типу файлу під час PUT-запиту файлу. Наприклад, якщо ви встановили contentType як “image/png” під час створення uploadUrl, переконайтеся, що встановлено Content-Type: image/png, а завантажуваний файл закінчується на .png. При успішному завантаженні буде повернуто відповідь 200.

Приклад завантаження двійкового файлу в Node.js

Ось приклад завантаження двійкового медіафайлу з використанням Node з JavaScript:

Приклад завантаження двійкового файлу в Postman

Ви також можете використовувати Postman для завантаження двійкового файлу до uploadUrl. У Postman:
  1. Виберіть HTTP-метод PUT.
  2. Вставте ваш uploadUrl у поле URL. Зверніть увагу, URL закінчиться через годину і може бути використаний лише один раз. Якщо ви робите виклик і він не вдається, ви маєте перегенерувати uploadUrl.
  3. У Headers встановіть Content-Type як content type, повернутий з ендпоінту /uploadUrl. Наприклад: Content-Type: image/png.
  4. Виберіть Body -> binary і виберіть файл для завантаження.
  5. Натисніть Send.
  6. Важливо: Не буде повернено жодної відповіді, тому ви маєте перевірити, чи було завантаження успішним, відкривши accessUrl, повернутий з ендпоінту /uploadUrl, у браузері. Ви також можете використовувати ендпоінт перевірки URL.
Postman Binary Upload

Приклад JSON-файлу Postman