Медиа

Получить ключ API

Эндпоинты

POST/v1/mediaGET/v1/mediaGET/v1/media/{id}DELETE/v1/media/{id}

Импорт по URL

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

bash
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.

bash
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
json
{
  "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.