HTTP API

标准化的 API 接口集成，通过界面配置快速完成API请求的编排与响应处理。

节点配置

节点有两种配置方式：

界面UI配置：逐一配置【请求信息、请求头、查询参数、请求体】
从cURL导入：解析提供的cURL，并自动配置好【请求信息、请求头、查询参数、请求体】

从cURL导入

以企微机器人通知的接口为例。

点击从cURL导入，在弹出的窗口中粘贴cURL，点击确定：

确定后会自动填充【请求信息、请求头、查询参数、请求体】配置。

UI配置

UI配置中的文本输入框都为数据流专用的PY文本输入框，对应文档：DPL_专用编辑器。

与普通文本框的区别在于，PY文本输入框支持用双花括号{{}}占位，在括号内可写PY表达式，例如引用预置变量等。

例如数据流的启动参数为{"entity":"A"}，PY文本输入框的内容为http://test.{{Pipeline.params.entity}}.com，则得到http://test.A.com

请求信息：目前支持GET、POST、PUT、PATCH、DELETE类型的调用，选择请求类型后，输入BaseURL，通常为?前的部分
请求头：键值对形式，点击+添加行。Content-Type参数会根据请求体类型自动识别，无需手动添加，手动添加的会被忽略
查询参数：键值对形式，点击+添加行。通常为完整URL中?后的部分
请求体：目前支持无、json、raw(text/plain)、xml类型，选择不同类型，需要输入不同的请求体内容
- 无：无需输入
- json：需要输入py表达式，执行时会转换为json字符串
- raw(text/plain)：PY文本输入框，可以用双花括号{{}}占位，在括号内可用PY表达式
- xml：也是PY文本输入框，可以用双花括号{{}}占位，在括号内可用PY表达式

其他设置

超时时间
- 支持自定义超时时间，当节点运行时间超过此处设置的超时时间，节点运行失败，进入节点异常处理流程
调用成功后参数转换：
- 当调用结果为200时，可对接口返回的结果进行转换，常用于提取嵌套数据或格式兼容等，原始返回的结果以变量’data’表示
- 例如此接口调用成功会，返回的内容是{"companyInfo":{"Code":"A","Name":"A公司"}}，参数转换内容为data.companyInfo.Code，则得到A。

调试结果

数据

调试结果为对应API定义的response，如果启用了【调用成功后参数转换】，当调用结果为200时，会对返回的结果进一步转换，例如：

cURL

提供本次调试对应的cURL，可复制：

使用案例

案例元素：https://alpha.deepfos.com/element-deep-pipeline/3-0-0?elementName=http_api&folderId=DIR1f57bbb34296&sign=YXBwSWQ9Y3pqbml3MDE5JnNwYWNlPWN6am5pdw%3D%3D

发送邮件（发给内部用户）

对应接口地址：system-server/message-service/push-email-message

配置参考：

Header：需要的信息可以从deepfos.OPTION.api.header获取

Body-json：

Copy

{
	'params': [
        {
			'messageScope': 'CONTENT', 
			'paramName': 'task_link', 
			'paramValue': 'www.baidu.com', 
			'scope': 2
			},
        {
			'messageScope': 'TITLE', 
			'paramName': 'title', 
			'paramValue': '待办通知', 
			'scope': 1
			}
        ], 

	"ccEmail": [{
		"id": Pipeline.run.initiator_id,
		"type": "USER"
	}],

	"receiver": [{
		"id": Pipeline.run.initiator_id,
		"type": "USER"
	}],

	"sender": Pipeline.run.initiator_id,

	"templateCode": "email_task",

	"attachment":[
		{"id":"U_1433955f-ee16-48c6-91d1-7aac9e4bfbb0",
		"space":Operator.pycode1.data.space},
		{"id":"U_3a31219c-3915-428d-80f3-bd46f4686d01",
		"space":Operator.pycode1.data.space},
	]
}

调试结果：

运行效果：

发送邮件（发给地址）

对应接口地址：system-server/message-service/send-email

配置参考：

Header：需要的信息可以从deepfos.OPTION.api.header获取

Body-json：

Copy

{
	'params': [
        {
			'messageScope': 'CONTENT', 
			'paramName': 'task_link', 
			'paramValue': 'www.baidu.com', 
			'scope': 2
			},
        {
			'messageScope': 'TITLE', 
			'paramName': 'title', 
			'paramValue': '待办通知', 
			'scope': 1
			}
        ], 

	"receiver": [
		"ya.li@deepfinance.com",
		"760366753@qq.com"
	],

	"ccEmail": [
		"463683222@qq.com",
		"lily_2017@outlook.com"
	],

	"sender": Pipeline.run.initiator_id,

	"templateCode": "email_task",

	"attachment":[
		{"id":"U_1433955f-ee16-48c6-91d1-7aac9e4bfbb0",
		"space":Operator.pycode1.data.space},
		{"id":"U_3a31219c-3915-428d-80f3-bd46f4686d01",
		"space":Operator.pycode1.data.space},
	]
}