HTTP 凭据任务
固定接口、显式参数、选择返回字段。
概览
为 HTTP 资源选择认证方式,再在任务中固定方法与 URL。普通参数在独立字段中声明,凭据插槽只由代理内部填充。测试连接只发送 HEAD,不会为了成功而改发业务请求。
边界与检查
只选择需要的 JSON Pointer 字段;不配置字段时只取得状态。HTTPS 验证证书和主机名,不跟随重定向。对 POST 等可能写入的请求,幂等键仅在本地去重,不保证远端恰好执行一次。
固定接口与认证
在“资源”中保存 HTTP 服务与认证方式:无认证、Bearer、Basic 或 API Key 请求头。带认证的业务服务使用 HTTPS;测试连接只发 HEAD,服务器拒绝 HEAD 不代表业务 API 不可用。任务中固定方法和具体 URL;用户名、密码、查询串与片段不放在 URL 里,查询参数另行配置。支持 GET、HEAD、POST、PUT、PATCH、DELETE,不跟随重定向。
请求与最小返回
固定文本、普通参数与凭据插槽分别配置。普通值可进入请求头、查询或顶层 JSON 对象;秘密只由代理内部填入允许的请求头或 JSON 字段,不返回给 AI。用户可选择 JSON Pointer,例如 /data/version,只返回必要字段;不选择字段时仅检查状态,不收集正文。返回正文限制 256 KiB,缺失字段或无效 JSON 会明确失败。
审批时核对方法、目标、所有参数、认证位置、接受状态码与返回字段。结果先脱敏再保存;过滤已知秘密不等于识别响应中所有业务敏感数据。HTTPS 验证证书与主机名,私有 CA 应进入受信任的系统配置;不要关闭验证。
写操作与失败
同一审批和幂等键只在本机复用同一运行,不保证远端只执行一次。POST、PUT、PATCH 或 DELETE 的超时、取消、断线后,先向目标系统核对结果,再决定是否重新申请。连接错误、无效 JSON、缺失字段或响应过大只暴露稳定错误代码,不回传服务器错误正文。