媒体导入或上传媒体
返回 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

其他任何错误，以错误结构返回。