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

Медиа

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

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

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

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

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

Авторизации

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

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

Заголовки

  • Idempotency-Keystring

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

Тело

application/json, multipart/form-data

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

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

  • urlstring

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

  • filestring<binary>

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

Ответ

201application/json

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

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

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

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

    Тип медиа

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

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

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

400

Неверное тело запроса.

401

Токен отсутствует, неизвестен, просрочен или отозван.

402

subscription_required.

403

live_mode_required для тестового приложения или нет разрешения media:write.

404

Заведение вне Workspace токена.

413

payload_too_large: больше предельного размера приложения.

422

media_import_refused с причиной: private_address, too_large, unsupported_media, unreachable, timeout, invalid_url, redirect_limit или removed_from_library. media_upload_refused для файла.

4XXapplication/json

Любая другая ошибка в конверте ошибки.