跳转到主要内容
POST
此端点允许你上传一个文件、图片或小型视频以用于你的帖子。将返回该图片的 URL,可在 /post 端点中使用。 你可以将文件作为 multipart form data 的表单参数,或作为 Base64 编码文件 的请求体参数进行传递。 有关媒体上传的重要说明:
  1. 为获得最佳性能,我们建议
    • 将媒体文件托管在你自己的服务器上(例如 AWS S3)。
    • 直接在 /post 端点的 mediaUrls 参数中传入媒体 URL。
    • 这种方式比通过此端点上传文件更快。
  2. 媒体文件保留
    • 已上传的文件保留 90 天。
    • 90 天后:
      • 已发布到社交网络的帖子不会受到影响。
      • 如果定时帖子引用了已过期的媒体,将无法发布。
  3. 文件大小限制
如果你的媒体已经可以通过外部 URL 访问(例如 S3 存储桶),可以跳过将文件上传到 Ayrshare 的步骤。只需在 POST 到 /post 端点时将外部可访问的 URL 放入 mediaURLs 请求体参数中,你的文件就会被自动上传。

Header Parameters

Content-Type
string
必填
如果发送 multipart form data,请使用 multipart/form-data,详见下文。否则,发送标准的 application/json

Body Parameters

file
string or object
必填
最大文件大小 30 MB。我们建议以 multipart form-data 对象形式发送,而不是 Base64 编码。
fileName
string
要上传的文件的名称。
description
string
文件的描述。

以 Multipart Form-Data 形式发送

以 multipart form-data 对象形式发送媒体文件。请务必按上文所述指定 Content-Type

以 Base64 形式发送

将媒体文件以 Base64 编码字符串的形式作为 Data URI 字符串发送。该字符串应以 data:content/type;base64 开头。 以 Data URI 为输出格式的编码示例: 注意:/post 端点支持通过 mediaUrls 参数使用外部 URL 传入更大的文件。