媒體取得媒體
返回 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

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