附件上傳
附件上傳串接
檔案上傳
說明
此 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
使用說明
準備要上傳的檔案
使用 multipart/form-data 格式發送 POST 請求
請求中必須包含有效的 API 金鑰
成功上傳後,系統會返回檔案的 ID 和存取 URL
注意事項
請確保您有適當的權限來使用此 API
檔案大小可能有限制,請參考帳號所屬組織購買的方案
支援的檔案類型如下
文檔:.doc, .docx, .txt, .pdf, .md
試算表:.xls, .xlsx, .csv
簡報:.ppt, .pptx
其他:.json, .jsonl
Last updated
Was this helpful?