SuperAPI AI 工具集

automation-pilot-executor-httprequest

部署与运维

查看项目

更新于 10-16 04:32

技能介绍

用途:介绍 Automation Pilot 中最常用的 HTTP 执行器 http-sapcp:HttpRequest:1,用于构建基于 HTTP 的命令。

主要能力与参数:url、method 为必填;headers、body、timeout(默认 5 秒,取值 1-90,建议不超过 10 秒)、responseBodyTransformer、user、password、tokenUrl、clientId、clientSecret、clientCert、refreshToken、successResponseCodes 可选。

表达式转义:URL 动态部分必须用 toUrlEncoded;JSON body 中的字符串值必须用 toEscapedJson,数字和布尔值不加引号;响应头必须用 getCaseInsensitive 访问。只能使用代码库中存在的函数,如 toObject、toNumber、toString、length、contains、isGuid、valueIn、filter、map、select、any、all、keys、values,不要自造函数。

响应转换:toObject 解析 JSON,可配合 .data.id、.resources[0].guid 提取嵌套值;toString、toNumber 做类型转换;不设置则返回原始响应。

超时与重试:timeout 为字符串秒数,最大 90 秒,更长操作建议轮询。autoRetry 适用于所有执行器类型,字段含 maxCount、delay、logic(仅 INCREMENTAL 或 FIXED)、applyOnValidation、when;when 为 null 时无条件重试。GET/DELETE/HEAD 可重试 408、429、500、502、503、504、-1;POST/PUT/PATCH 可重试 429、502、503、504;-1 表示网络错误。

认证:支持 user/password 配合 tokenUrl 的 OAuth、clientId/clientSecret 客户端凭证、clientCert 的 mTLS、refreshToken(提供后忽略 user/password)。

errorMessages 同样适用于所有执行器,可按状态码定制错误信息;错误体可用 toObject.error.message 或 toObject.errors[0].detail 访问,需按实际响应结构判断。

限制:资料未提供具体收费、平台支持范围或效果数据。