媒体列出媒体
返回 Sofia

媒体

列出媒体

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

GEThttps://api.sofia-post.com/api/v1/media
GEThttps://api.sofia-post.com/api/v1/media

列出媒体

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

授权

Authorizationstring必填

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

仅保存在此标签页中，且仅发送到 api.sofia-post.com。 获取 API 密钥

查询参数

establishmentIdstring必填

要读取其媒体库的门店。

cursorstring

上一页返回的 nextCursor。

limitnumber

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

商家的媒体按最新优先、逐页返回：参见分页。

每个媒体的 url 都经过签名并会过期：请保存 id，需要新的 URL 时，用 `GET /v1/media/{id}` 重新读取该媒体。

授权

  • Authorizationstringheader必填

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

查询参数

  • establishmentIdstring必填

    要读取其媒体库的门店。

  • cursorstring

    上一页返回的 nextCursor。

  • limitnumber

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

响应

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

  • dataobject[]必填

    本页的媒体

    显示子属性
    • idstring必填

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

    • typestring必填

      媒体类型

      允许的值： imagevideo

    • urlstring必填

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

    • fileNamestring必填

      文件名

    • contentTypestring必填

      文件的 MIME 类型

    • sizenumber必填

      大小，单位为字节

    • createdAtstring<date-time>必填

      媒体的添加时间

    • thumbnailUrlstring

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

  • nextCursorstring

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

这个页面对你有帮助吗？