Media

Endpoint

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

Impor dari URL

Kirim JSON berisi establishmentId dan url https publik. Sofia mengunduh file itu sendiri, memeriksanya, dan menyimpannya di pustaka media.

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

Unggah file

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

Yang diterima

Gambar dan video, hingga 200 MB.
URL harus https publik: alamat privat, lebih dari 3 pengalihan, atau unduhan lebih dari 30 detik akan 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 dijawab 422 media_import_refused atau media_upload_refused, dengan alasan di details dan langkah yang perlu dilakukan di message.