МедиаИмпортировать или загрузить медиа
Назад к Sofia

Медиа

Импортировать или загрузить медиа

Добавляет в медиатеку заведения файл (multipart) или URL https, который Sofia скачивает сама. Нужны live-приложение и активная подписка.

POSThttps://api.sofia-post.com/api/v1/media
POSThttps://api.sofia-post.com/api/v1/media

Импортировать или загрузить медиа

Добавляет в медиатеку заведения файл (multipart) или URL https, который Sofia скачивает сама. Нужны live-приложение и активная подписка.

Авторизации

Authorizationstringобязательно

Ваш личный ключ или токен доступа OAuth, отправляется как Bearer <token>.

Хранится только в этой вкладке и отправляется только на api.sofia-post.com. Получить ключ API

Заголовки

Idempotency-Keystring

При повторе с тем же телом запрос возвращает тот же ответ без второго импорта. Охватывает поля формы, но не байты файла.

Тело

Этот запрос действует на ваш реальный аккаунт.

Импорт по URL

Отправьте JSON с establishmentId и публичным https url. Sofia сама скачивает файл, проверяет его и раскладывает в медиатеку.

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"establishmentId":"'$ESTABLISHMENT_ID'","url":"https://images.example.com/tatin.jpg"}'

Загрузка файла

Либо отправьте сам файл в multipart/form-data с полем file.

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -F establishmentId=$ESTABLISHMENT_ID \
  -F file=@tatin.jpg
{
  "id": "393d5aa4-16f1-430f-b1d8-1fb1473076ef",
  "type": "image",
  "url": "https://…/393d5aa4-16f1-430f-b1d8-1fb1473076ef.jpg?X-Amz-…"
}

Что принимается

  • Изображения и видео до 200 МБ.
  • URL должен быть публичным https: закрытый адрес, более 3 перенаправлений или более 30 секунд загрузки отклоняются.
  • Возвращаемый url подписан и истекает: сохраняйте id и перечитывайте медиа через GET /v1/media/{id}, когда нужен свежий URL.

Отклонённый файл возвращает 422 media_import_refused или media_upload_refused с причиной в details и порядком действий в message.

Авторизации

  • Authorizationstringheaderобязательно

    Ваш личный ключ или токен доступа OAuth, отправляется как Bearer <token>.

Заголовки

  • Idempotency-Keystring

    При повторе с тем же телом запрос возвращает тот же ответ без второго импорта. Охватывает поля формы, но не байты файла.

Тело

application/json, multipart/form-data
  • establishmentIdstringобязательно

    Заведение, медиатека которого получает медиа

  • urlstring

    JSON: адрес https медиа, которое Sofia скачивает сама (без файла)

  • filestring<binary>

    multipart/form-data: файл (изображение или видео), без url

Ответ

Медиа, добавленное в медиатеку.

  • idstringобязательно

    Идентификатор медиа, передаётся в media[].id публикации

  • typestringобязательно

    Тип медиа

    Допустимые значения: imagevideo

  • urlstringобязательно

    Подписанный адрес, действует на текущее окно

Эта страница была полезной?