媒体列出媒体
返回 Sofia

媒体

列出媒体

按从新到旧分页列出门店的媒体库，附当前时间窗口内有效的签名 URL。在测试模式和正式模式下都可以使用，用于挑选已有素材。

GEThttps://api.sofia-post.com/api/v1/media
GET/v1/media
curl -X GET 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

授权

  • Authorizationstring必填

    你的个人密钥或 OAuth 访问令牌，以 Bearer <token> 发送。

查询参数

  • establishmentIdstring必填

    要读取其媒体库的门店。

  • cursorstring

    上一页返回的 nextCursor。

  • limitnumber

    每页数量，1 到 100（默认 20）。

响应

200application/json

一页媒体；还有更多时包含 nextCursor。

  • dataobject[]必填

    本页的媒体

    显示子属性
    • idstring必填

      媒体的标识符，传给帖子的 media[].id

    • typestring必填

      媒体类型

      允许的值： imagevideo

    • urlstring必填

      带签名的地址，在当前时间窗口内有效

    • fileNamestring必填

      文件名

    • contentTypestring必填

      文件的 MIME 类型

    • sizenumber必填

      大小，单位为字节

    • createdAtstring<date-time>必填

      媒体的添加时间

    • thumbnailUrlstring

      带签名的缩略图（视频为封面，图片为方图）

  • nextCursorstring

    作为 ?cursor= 传入以获取下一页；到末尾时不再出现

400

invalid_cursor，或 invalid_request。

404

establishment_not_found：令牌无法访问该门店。

4XXapplication/json

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