Media

Impor atau unggah media

Menambahkan file (multipart) atau URL https yang diambil Sofia ke pustaka media sebuah usaha. Perlu aplikasi live dan langganan aktif.

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

POST/v1/media

Kunci API atau access tokenHanya disimpan di tab ini, dan hanya dikirim ke api.sofia-post.com.Idempotency-Key (header)Body permintaan

Permintaan ini bertindak pada akun asli Anda.

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"}'

Otorisasi

Authorizationstringwajib
Kunci pribadi atau access token OAuth Anda, dikirim sebagai Bearer <token>.

Header

Idempotency-Keystring
Bila diulang dengan body yang sama, permintaan mengembalikan respons yang sama tanpa impor kedua. Mencakup kolom formulir, bukan byte file.

Body

application/json, multipart/form-data

establishmentIdstringwajib
Usaha yang pustaka medianya menerima media
urlstring
JSON: alamat https media, yang diambil Sofia sendiri (tanpa file)
filestring<binary>
multipart/form-data: file (gambar atau video), tanpa url

Respons

201application/json

Media yang ditambahkan ke pustaka.

idstringwajib
Pengenal media, untuk diteruskan di media[].id sebuah postingan
typestringwajib
Jenis media
Nilai yang diizinkan: imagevideo
urlstringwajib
Alamat bertanda tangan, berlaku untuk jendela saat ini

400

Body salah format.

401

Token tidak ada, tidak dikenal, kedaluwarsa, atau dicabut.

402

subscription_required.

403

live_mode_required untuk aplikasi uji, atau scope media:write tidak ada.

404

Usaha di luar Workspace token.

413

payload_too_large: melebihi batas ukuran aplikasi.

422

media_import_refused, beserta alasannya: private_address, too_large, unsupported_media, unreachable, timeout, invalid_url, redirect_limit, atau removed_from_library. media_upload_refused untuk file.

4XXapplication/json

Kesalahan lain apa pun, dalam amplop kesalahan.