MakAgent在线文档

Appearance

HTTP请求 ​

执行 HTTP 请求，与其他服务或 API 进行数据交互。

请求配置 ​

方法 ​

选择 HTTP 请求方法：GET、POST、PUT、DELETE 等。

URL ​

设置请求的目标 URL 地址。

内容类型 ​

指定 Content-Type 请求头，定义请求体的数据格式。

请求头 ​

配置 HTTP 请求头，支持自定义头部信息。

请求体 ​

设置请求的主体数据内容。

Fallback ​

当 HTTP 请求失败或出错时执行的备用流程。

响应处理 ​

应答类型 ​

设置响应数据的解析类型，默认为 JSON 格式。

访问数据 ​

使用点表示法提取响应数据中的特定字段。

示例：对于以下 JSON 响应：

json
{
	"status": 200,
	"data": {
		"name": "Prices",
		"values": [
			{ "id": 1, "value": 4000 },
			{ "id": 2, "value": 24000 }
		]
	}
}
{
	"status": 200,
	"data": {
		"name": "Prices",
		"values": [
			{ "id": 1, "value": 4000 },
			{ "id": 2, "value": 24000 }
		]
	}
}
  • 获取 values 数组：data.values
  • 获取第一个元素的 value：data.values.0.value

TIP

输入 $response 如果想要获取所有 HTTP 响应, 如 status, statusText, data, 等。

分配给变量 ​

将提取的数据保存到变量中。

  • 变量名称：指定存储响应数据的变量名称。

插入表格 ​

将响应数据插入到表格中。

  • 选择列：指定数据插入的目标列。

表单数据 ​

当使用multipart/form-data作为标头时,请求正文将作为FormData发送. 因此，在编写正文时必须遵循以下格式

json
[
	["name", "value"],
	["name 2", "value 2"]
]
[
	["name", "value"],
	["name 2", "value 2"]
]

在值字段中，你可以写入文件在你本地计算机中的绝对路径，或者要上传的文件的 URL。例如:

json
[
	["audio", "C:\\Downloads\\files\\music.mp3"],
	["image", "https://example.com/image.png"]
]
[
	["audio", "C:\\Downloads\\files\\music.mp3"],
	["image", "https://example.com/image.png"]
]

在body里使用表达式 ​

在主体内部编写表达式 来访问变量, 表等数据不方便手，因为它的最终结果必须是有效的 JSON。为了防止出现“内容主体不是有效的 JSON”错误，请遵循以下规则：

  • 字符串值
    如果引用的数据的值是字符串，则必须将 标签括在双引号 (") 内。例如
json
{
	"name": "{{variables.name}}",
	"email": "{{variables.email}}"
}
{
	"name": "{{variables.name}}",
	"email": "{{variables.email}}"
}
  • 多行字符串值
    如果你引用的数据的值是字符串，且其中包含换行符，则必须在数据关键字前添加感叹号（！）。例如，
json
{
	"longText": {{!variables.article}}
}
{
	"longText": {{!variables.article}}
}

TIP

使用JavaScript 表达式时不需要这样做。

  • 其他
    如果你引用的数据的值是对象、数组等，那么可以直接在 body 里面写 标签。例如，
json
{
	"profile": {{variables.userProfile}}, // { name: 'John Doe', email: 'john@example.com' }
	"stats": {{variables.stats}} // [10, 200, 87, 21]
}
{
	"profile": {{variables.userProfile}}, // { name: 'John Doe', email: 'john@example.com' }
	"stats": {{variables.stats}} // [10, 200, 87, 21]
}

如果你是JavaScript表达式, 则需要将表达式包装在$stringify 函数内部。

json
{
	"profile": {{$stringify(variables.userProfile)}},
	"stats": {{$stringify(variables.stats)}}
}
{
	"profile": {{$stringify(variables.userProfile)}},
	"stats": {{$stringify(variables.stats)}}
}