附件上傳

附件上傳串接

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

檔案上傳

說明

此 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