媒体获取媒体
返回 Sofia

媒体

获取媒体

返回媒体库中的一项媒体，附当前时间窗口内有效的签名 URL，其标识符可在发布帖子时直接复用，无需重新上传文件。

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

授权

  • Authorizationstring必填

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

路径参数

  • idstring必填

    媒体的标识符。

响应

200application/json

媒体及其签名 URL。

  • idstring必填

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

  • typestring必填

    媒体类型

    允许的值： imagevideo

  • urlstring必填

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

401

令牌缺失、未知、已过期或已被撤销。

403

令牌没有 media:read scope。

404

media_not_found：不在该 Workspace 的门店内。

4XXapplication/json

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