ProtoFlux:POST String 节点介绍
POST String 节点介绍
POST String 节点在被调用时会使用 HTTP POST 方法发送请求,并根据 Content-Type 响应头中指定的字符集对返回内容进行解码。 如果响应头中没有指定字符集,或者不存在该响应头,则默认使用 UTF-8 编码。如图所示:
提示: 目前暂不支持通过 BasicAuth 等方式进行身份验证(Authorization)。
注意:
- 该节点不适合传输二进制数据,因为它会将整个响应解码为人类可读的字符串。如果你需要获取远程资源(如 Texture2D 贴图),请考虑使用 Asset Providers(资源提供程序)相关的组件。
- 由于涉及外部网络连接,执行时可能会弹出安全/授权提示。建议由确实需要执行数据传输任务的用户端触发脉冲。
节点概览
| 属性 | 说明 | |
|---|---|---|
| 分类 (Category) | Network (网络) | 归属于网络通信类别。 |
| 输入 (Inputs) | * (AsyncCall) URL (Uri) String (String) MediaType (String) |
触发信号、目标网址、发送的内容及其媒体类型。 |
| 输出 (Outputs) | OnSent, OnResponse, OnError, OnDenied, StatusCode, Content | 包含状态反馈、错误处理及服务器返回的文本内容。 |
输入 (Inputs)
- * (AsyncCall):触发器。激活后将向指定的 URL 服务器位置发送 POST 请求。
- URL (Uri):目标服务器的地址。
- String (String):要发送给接收端的字符串文本(即 POST 请求的正文内容)。
- MediaType (String):媒体类型(也称为 Content Type)。默认值为
"application/json"。关于媒体类型的详细信息,可参考 Media Type (MIME)。
输出 (Outputs)
- OnSent (AsyncCall):在请求发送后立即触发。这允许并行执行多个异步函数。
- OnResponse (Continuation):当服务器成功响应并发送基于字符串的内容时触发。在此脉冲期间,节点会通过相应的输出端口提供数据。
- OnError (Continuation):当 HTTP 客户端判定请求失败时触发(例如:网络连接问题、DNS 失败、服务器证书验证失败或超时)。
- OnDenied (Continuation):当处理请求的用户拒绝了该主机的访问权限,或者因其设置而被拒绝时触发。
- StatusCode (HTTP Status Code):服务器返回的状态码(如 200, 404, 500)。无论请求成功、失败还是被拒绝,都会返回对应代码。该值仅在 OnResponse、OnError 和 OnDenied 脉冲期间有效,默认为 0。
- Content (String):服务器返回的响应内容,或者是 HTTP 请求期间抛出的异常消息。该值仅在 OnResponse 脉冲期间有效。

No comments to display
No comments to display