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

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

{
  "id": "string",
  "type": "image",
  "url": "string"
}

Impor atau unggah media

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

{
  "id": "string",
  "type": "image",
  "url": "string"
}

Mengimpor dari URL

Kirim JSON dengan establishmentId dan url https publik. Sofia mengunduh sendiri filenya, memeriksanya, dan menyimpannya di pustaka 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":"'$ESTABLISHMENT_ID'","url":"https://images.example.com/tatin.jpg"}'

Mengunggah file

Atau kirim file itu sendiri dalam multipart/form-data, dengan kolom 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-…"
}

Yang diterima

Gambar dan video, hingga 200 MB.
URL harus berupa https publik: alamat privat, lebih dari 3 pengalihan, atau unduhan lebih dari 30 detik ditolak.
url yang dikembalikan bertanda tangan dan kedaluwarsa: simpan id-nya, dan baca ulang media dengan GET /v1/media/{id} saat Anda butuh URL baru.

File yang ditolak menjawab 422 media_import_refused atau media_upload_refused, dengan alasan di details dan langkah yang harus diikuti di message.

Otorisasi

Authorizationstringheaderwajib
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

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

Apakah halaman ini membantu?