跳转到主要内容
POST
此端點可讓您上傳檔案,或上傳圖片、小型影片以包含在您的貼文中。回傳的圖片 URL 可用於 /post 端點。 您可以將檔案以 multipart form data 作為表單參數傳送,或以 Base64 編碼的檔案作為主體參數傳送。 關於媒體上傳的重要說明:
  1. 為了達到最佳效能,我們建議
    • 將媒體檔案託管在您自己的伺服器(例如 AWS S3)。
    • 直接在 /post 端點的 mediaUrls 參數中傳入媒體 URL。
    • 此方式比透過此端點上傳檔案更快。
  2. 媒體檔案保留期
    • 上傳的檔案會保留 90 天。
    • 90 天後:
      • 已發布至社群網路的貼文不受影響。
      • 已排程貼文若引用過期媒體,將無法成功發布。
  3. 檔案大小限制
如果您的媒體已可透過外部 URL(例如 S3 儲存桶)存取,就不必再將檔案上傳到 Ayrshare。只要在 POST 到 /post 端點時,將外部可存取的 URL 放入 mediaURLs 請求主體參數,您的檔案就會被自動上傳。

標頭參數

Content-Type
string
必填
若傳送 multipart form data,請使用 multipart/form-data — 請參見下方。否則使用標準的 application/json

主體參數

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 接受較大的檔案。