媒體

匯入或上傳媒體

把檔案（multipart）或 Sofia 抓取的 https URL 新增到門市媒體庫。需要正式應用和有效訂閱。

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

匯入或上傳媒體

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

從 URL 匯入

傳送包含 establishmentId 和一個公開 https url 的 JSON。Sofia 會自己下載檔案、檢查並歸入媒體庫。

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 欄位。

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

接受的內容

圖片和影片，最大 200 MB。
URL 必須是公開的 https：私有地址、超過 3 次重新導向或下載超過 30 秒都會被拒絕。
返回的 url 經過簽名並會過期：請儲存 id，需要新的 URL 時，用 GET /v1/media/{id} 重新讀取該媒體。

被拒絕的檔案會返回 422 media_import_refused 或 media_upload_refused，原因在 details 中，處理辦法在 message 中。

授權

Authorizationstringheader必填
你的個人金鑰或 OAuth 存取權杖，以 Bearer <token> 傳送。

標頭

Idempotency-Keystring
用相同請求本文重放時回傳相同回應，不會再匯入一次。它覆蓋表單欄位，不包括檔案位元組。

請求本文

application/json, multipart/form-data

establishmentIdstring必填
接收媒體的媒體庫所屬的門市
urlstring
JSON：媒體的 https 位址，由 Sofia 自行抓取（不帶檔案）
filestring<binary>
multipart/form-data：檔案（圖片或影片），不帶 url

回應

已新增到媒體庫的媒體。

idstring必填
媒體的識別碼，傳給貼文的 media[].id
typestring必填
媒體類型
允許的值： imagevideo
urlstring必填
帶簽章的位址，在目前時間視窗內有效

這個頁面對你有幫助嗎？