跳转到主要内容
GET
对于大于 10 MB 的文件上传,请获取一个预签名 URL 来上传文件。
  • 最大文件上传大小为 5 GB。
  • 上传预签名 URL 生成后有效期为 30 分钟。
  • Access URL 在上传后可用 30 天。所有已发布的帖子在社交网络端不会受到影响。超过该时间的定时帖子会在发布时报错。
如果你的媒体已经可以通过外部 URL 访问(例如 S3 存储桶),可以跳过将文件上传到 Ayrshare 的步骤。只需在 POST 到 /post 端点时将外部可访问的 URL 放入 mediaURLs 请求体参数中,你的文件就会被自动上传。

Header Parameters

Query Parameters

fileName
string
如果没有提供 contentType,则必须提供带扩展名的完整文件名。要上传的文件名称。必须包含扩展名,例如 .png、.jpg、.mov、.mp4 等。
contentType
string
要上传的媒体的 content-type。有效格式包括:mp4movpngjpgjpeg例如,如果文件是 Quicktime .mov 文件,则 contentType 应为 mov如果未提供,将使用 application/octet-stream。

响应详情

  • accessUrl 是上传后用于访问媒体文件的 URL。
  • contentType 是为待上传媒体设置的 content-type。上传媒体时,请在 Content-Type 头中使用它。
  • uploadUrl 是用于 PUT 媒体文件的 URL。请参见下文。

其他端点示例

上传大文件的流程:
  • 通过 /media/uploadUrl 端点获取 uploadURLaccessURL。请参见上文。
  • 使用 PUT 方法上传文件,并将 Content-Type 设置为返回的 contentType
  • 使用 --upload-file 配合媒体文件和 uploadUrl 上传媒体。
  • 上传成功时,将返回 200 响应。
  • 上传媒体文件后,在 POST 到 /post 端点时将 accessUrl 放入 mediaUrls 请求体参数中。
  • 预签名上传 URL 只能上传一次。如果发送了错误的文件,你必须创建一个新的上传 URL。文件上传失败时不会产生错误响应。请参见下文的验证 URL 是否存在
请务必确保创建 uploadUrl 时设置的 contentType,与 PUT 文件时使用的 Content-Type 及文件类型一致。 例如,如果创建 uploadUrl 时将 contentType 设为 “image/png”,请务必设置 Content-Type: image/png,并且上传的文件以 .png 结尾。 上传成功时,将返回 200 响应。

在 Node.js 中上传二进制文件的示例

以下是使用 Node.js 上传二进制媒体文件的 JavaScript 示例:

在 Postman 中上传二进制文件的示例

你也可以使用 Postman 将二进制文件上传到 uploadUrl 在 Postman 中:
  1. 选择 HTTP 方法 PUT
  2. 将你的 uploadUrl 粘贴到 url 字段中。请注意,URL 会在一小时后过期,且只能使用一次。如果调用失败,你必须重新生成 uploadUrl
  3. Headers 中,将 Content-Type 设置为 /uploadUrl 端点返回的 content type。例如:Content-Type: image/png
  4. 选择 Body -> binary 并选择要上传的文件。
  5. 按下 Send
  6. 重要提示:不会返回任何响应,因此你应通过在浏览器中打开 /uploadUrl 端点返回的 accessUrl 来检查上传是否成功。你也可以使用验证 URL 端点
Postman Binary Upload

Postman 示例 JSON 文件