使用API向dust（eu.dust.tt）上传文档遇问题，求正确curl命令

架构老林

2026-6-11

Dust平台文档上传失败问题及解决建议

操作背景与报错信息

1. 已执行的GET请求（列出文档）

命令：

curl --request GET --url https://eu.dust.tt/api/v1/w/{wId}/spaces/{spaceId}/data_sources/{dsId}/documents --header 'accept: application/json' --header 'Authorization: Bearer {APIKey}'

返回结果（200 OK）：

{
   "total" : 3,
   "documents" : []
}

2. 上传文档的POST请求及错误

命令：

curl --request POST --url https://eu.dust.tt/api/v1/w/{wId}/spaces/{spaceId}/data_sources/{dsId}/documents --header "Authorization: Bearer {APIKey}" -F "file=@File1.csv"

错误响应：

{"error":{"type":"method_not_supported_error","message":"The method passed is not supported, GET is expected."}}

问题分析与解决方案

错误提示明确/documents端点仅支持GET请求，因此上传/更新文档需使用平台提供的专用写入端点，以下是两种可行的命令尝试：

方案1：PUT请求单文件Upsert

若平台支持通过PUT直接创建或覆盖文档，使用此命令：

curl --request PUT \
  --url https://eu.dust.tt/api/v1/w/{wId}/spaces/{spaceId}/data_sources/{dsId}/documents/File1.csv \
  --header "Authorization: Bearer {APIKey}" \
  --header "Content-Type: text/csv" \
  --data-binary @File1.csv

方案2：POST请求批量上传端点

多数数据平台会提供批量文档操作端点，尝试使用/documents/batch路径：

curl --request POST \
  --url https://eu.dust.tt/api/v1/w/{wId}/spaces/{spaceId}/data_sources/{dsId}/documents/batch \
  --header "Authorization: Bearer {APIKey}" \
  -F "files=@File1.csv"