网络请求POST

函数名：http_Post / http_Post

功能描述

执行 HTTP POST 请求，向指定 URL 提交数据。采用异步执行模式，Content-Type 默认为 application/json，适用于向 Web 接口提交 JSON 数据或表单参数。

会员等级：🟢 免费版（Free）

语法

=http_Post(url, queryString)

参数

参数名	类型	必填	默认值	说明
url	String	是	—	网络请求地址
queryString	String	否	""	请求参数，通常为 JSON 格式字符串

返回值

String — 返回 URL 对应的响应内容。异步执行期间返回"Waiting..."，完成后返回实际响应内容。

使用示例

示例一：提交 JSON 数据

向 API 提交 JSON 格式的数据。

公式：

=http_Post("https://api.example.com/submit", "{\"name\":\"张三\",\"age\":25}")

结果：

{"status":"success","message":"数据提交成功"}

示例二：无参数 POST 请求

向指定 URL 发送无参数的 POST 请求。

公式：

=http_Post("https://api.example.com/trigger")

结果：

{"code":200,"result":"操作已执行"}

示例三：引用单元格参数

将 URL 和请求数据存放在单元格中，通过引用动态提交。

公式：

=http_Post(A1, B1)

结果：

（A1 为 URL，B1 为请求参数，返回对应响应内容）

技术说明

请求配置

• 请求方式：POST
• User-Agent：Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20100101 Firefox/17.0
• Content-Type：application/json
• 超时时间：60 秒
• 自动跳转：禁止（AllowAutoRedirect = false）
• 编码方式：UTF-8
• 执行模式：异步执行（ExcelAsyncUtil.Run），避免阻塞 Excel 界面

参数提交

queryString 参数作为 POST 请求体直接提交。由于 Content-Type 为 application/json，建议传入合法的 JSON 字符串以获得最佳兼容性。

错误处理

错误场景	返回值
请求过程中发生异常	异常：{异常信息}
异步任务尚未完成	Waiting...
URL 无法连接或无效	异常：{连接错误信息}