附件上傳

附件上傳串接

建議請先閱讀上一章的「檔案上傳」

檔案上傳

說明

此 API 整合了原本分散的檔案上傳流程,將取得 Presigned URL、上傳檔案至雲端儲存以及上傳至 Attachment 的功能整合為單一端點。

端點資訊

  • URL: https://api.maiagent.ai/api/v1/attachments-upload/

  • 方法: POST

  • 內容類型: multipart/form-data

請求參數

參數名
類型
必填
說明

file

string(binary)

要上傳的檔案

請求標頭

Accept: application/json Authorization: Api-Key {您的API金鑰}

請求範例

使用 curl 發送請求:

curl -X 'POST' \
  "https://api.maiagent.ai/api/v1/attachments-upload/" \
  -H 'accept: application/json' \
  -H 'Authorization: YOU_API_KEY' \
  -H 'Content-Type: multipart/form-data' \
  -H 'X-CSRFTOKEN: B85SZ7NcBcOKGl4xXU9cSfFhoLG7larxgCy2RYoz0mKSvcQydAboukuKCCKjGKV' \
  -F 'file=@32d91c61-79b3-40e1-b47d-e35d6d30861檔案.xls;type=application/vnd.ms-excel'

回應

成功回應 (狀態碼: 201)

{
  "id": "c0f4b764-7cb8-4f1f-a1d4-80de93e6c3cc",
  "type": "other",
  "filename": "32d91c61-79b3-40e1-b47d-e35d6d30861檔案.xls",
  "file": "https://api.maiagent.ai/media/chat/attachment/b82359c-cdd9-4cac-8ab1-c15be90e4d9b.xls"
}

回應欄位說明

欄位名
類型
說明

id

string

檔案的唯一識別碼

type

string

檔案類型,例如 "other"

filename

string

原始檔案名稱

file

string

檔案的存取 URL

使用說明

  1. 準備要上傳的檔案

  2. 使用 multipart/form-data 格式發送 POST 請求

  3. 請求中必須包含有效的 API 金鑰

  4. 成功上傳後,系統會返回檔案的 ID 和存取 URL

注意事項

  • 請確保您有適當的權限來使用此 API

  • 檔案大小可能有限制,請參考帳號所屬組織購買的方案

  • 支援的檔案類型如下

文檔:.doc, .docx, .txt, .pdf, .md
試算表:.xls, .xlsx, .csv
簡報:.ppt, .pptx
其他:.json, .jsonl

Last updated

Was this helpful?