媒體匯入或上傳媒體
返回 Sofia

媒體

匯入或上傳媒體

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

POSThttps://api.sofia-post.com/api/v1/media
POST/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"}'

授權

  • Authorizationstring必填

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

標頭

  • Idempotency-Keystring

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

請求本文

application/json, multipart/form-data

  • establishmentIdstring必填

    接收媒體的媒體庫所屬的門市

  • urlstring

    JSON：媒體的 https 位址，由 Sofia 自行抓取（不帶檔案）

  • filestring<binary>

    multipart/form-data：檔案（圖片或影片），不帶 url

回應

201application/json

已新增到媒體庫的媒體。

  • idstring必填

    媒體的識別碼，傳給貼文的 media[].id

  • typestring必填

    媒體類型

    允許的值： imagevideo

  • urlstring必填

    帶簽章的位址，在目前時間視窗內有效

400

請求本文格式錯誤。

401

權杖缺失、未知、已過期或已被撤銷。

402

subscription_required。

403

測試應用回傳 live_mode_required，或缺少 media:write scope。

404

不在權杖所屬 Workspace 內的門市。

413

payload_too_large：超過應用的大小限制。

422

media_import_refused 並附原因：private_address、too_large、unsupported_media、unreachable、timeout、invalid_url、redirect_limit 或 removed_from_library。檔案則為 media_upload_refused。

4XXapplication/json

其他任何錯誤，以錯誤結構回傳。