VoiceFlow知识库文档API：Insomnia可用但cURL执行报错排查

问题场景 #

在VoiceFlow中调用「Replace Document (non-url)」接口实现程序化知识更新，请求在Insomnia中可正常运行，但导出为cURL命令在Windows环境执行时出现报错。已确认文档路径、API密钥正确，文件位于当前工作目录，尝试过URL加引号/不加引号的情况仍无效。

执行的cURL命令 #

curl --request PUT 
     --url 'https://api.voiceflow.com/v3alpha/knowledge-base/docs/<document id>/upload?maxChunkSize=1000' 
     --header 'Authorization: <api key>' 
     --header 'accept: application/json' 
     --header 'content-type: multipart/form-data' 
     --form file='@Jaberwocky.txt'

报错信息 #

curl: (3) URL rejected: Bad hostname
curl: (6) Could not resolve host: application
curl: (6) Could not resolve host: multipart

错误原因 #

1. Windows CMD不支持单引号：Insomnia导出的cURL使用单引号包裹参数，但Windows命令提示符（CMD）仅识别双引号作为字符串分隔符。单引号会被当作普通字符处理，导致header参数被拆分（比如'accept:被视为独立参数，application/json'被解析为主机名），引发“无法解析主机”的错误。
2. 换行无续行符：Windows CMD中多行命令需要用^作为续行符，原命令直接换行会导致命令被截断，部分参数被当作新命令执行。

修正后的命令 #

将所有单引号替换为双引号，添加Windows CMD兼容的续行符^，并替换占位符为真实值：

curl --request PUT ^
     --url "https://api.voiceflow.com/v3alpha/knowledge-base/docs/你的实际文档ID/upload?maxChunkSize=1000" ^
     --header "Authorization: 你的实际API密钥" ^
     --header "accept: application/json" ^
     --header "content-type: multipart/form-data" ^
     --form file="@Jaberwocky.txt"

补充说明 #

• 若使用PowerShell执行，虽支持单引号，但@符号有特殊含义，需用双引号包裹file="@Jaberwocky.txt"避免解析错误。
• 确保已移除<document id>和<api key>的尖括号，替换为真实的文档ID与API密钥。

内容的提问来源于stack exchange，提问作者Larry Holze