API

添加云函数

1、点击云函数下方的"添加API"按钮，在API模板界面点击“新建空白API”，在弹出窗口中输入API名称，点击确定。

2、在配置页配置输入、输出参数、并填写配置表。

3、切换至“编程”标签，现在您可以在代码编辑器中定义云函数了。如果你熟悉JS脚本语言，编写API非常简单，你只需要在run方法中补充您的业务逻辑代码就可以了。

run方法包含了3个参数

input：输入参数。通过“input.key”调用配置中添加的输入参数。

output：输出参数。通过“output.key”调用配置中添加的输出参数。

modules：可调用模块。

详情请参考API开发文档。

这里以实现在企业微信上传临时素材功能为例介绍云函数具体使用流程：根据企业微信API模板创建一个API实现接受一个image_url参数，返回素材mediaID及素材创建时间createAT。

API配置如下：

代码如下：

通过在线调试工具测试结果(测试前请请先将代码保存，并保持开启状态)：

调用云函数

1、在调用云函数前，请确保云函数测试无误可用，并将云函数启用(在云函数的基本信息中将状态开关打开即可。

2、创建一个功能，进入功能编辑页，添加一个步骤，类型选择“API”，操作选择“自定义api”，模板选择开启的云函数。

3、点击此步骤的“设置”按钮，即可看到此API包含的输入输出参数。现在你可以将输入参数设为其他步骤中的相关数值，以传入云函数

4、创建一个步骤来使用API的输出参数。

5、发布功能，运行后即可在数据库中看到API返回的相应数据。

webhook

添加webhook

1、点击webhook下方的"添加API"按钮，在API模板界面点击“新建空白API”，在弹出窗口中输入API名称，设定webhook路径(此路径为第三方发起该webhook请求的路径)，点击确定。

2、在配置页填写配置表。

3、切换至“编程”标签，现在您可以在代码编辑器中定义webhook了。如果你熟悉JS脚本语言，编写API非常简单，你只需要在hook方法中补充您的业务逻辑代码就可以了。

hook方法包含了3个参数：

req：请求对象，可以获取网络请求中的参数。

resp：回应对象，可以将webhook的执行结果返回到请求方。

modules：可调用模块。

详情请参考API开发文档。

由于webhook属于被动式接收数据，而功能属于主动式处理，因此不支持在功能步骤中处理webhook接收的数据。需要在webhook中通$modules.program.exec（$flow,$form,$version）调用一个功能来记录处理接收的数据。

这里以实现在接收企业微信添加企业客户事件回调数据的功能为例介绍webhook具体使用流程：根据企业微信API模板创建一个API实现记录成员添加外部联系人信息。

API配置如下：

代码如下：

调用功能如下：

调用webhook

以上文配置的webhook为例：

1、保证API编写无误后，将API保持开启状态。

2、在第三方配置此webhook的路径。

3、在第三方触发回调事件，在白码数据库查看回调信息。

1）使用企业微信成员账号将微信用户“添加为联系人”

2）在数据库中查看回调数据