媒體

端點

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

從 URL 匯入

傳送包含 establishmentId 和公開 https url 的 JSON。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 MB。
URL 必須是公開的 https：私人位址、超過 3 次重新導向或下載超過 30 秒都會被拒絕。
回傳的 url 帶有簽章且會過期：請保存 id，需要新 URL 時用 GET /v1/media/{id} 重新讀取該媒體。

被拒絕的檔案會回傳 422 media_import_refused 或 media_upload_refused，原因見 details，處理方式見 message。