【开天aPaaS工作台火热公测中】3-进阶任务操作指导：创建连接器并创建流
3. 进阶任务-创建连接器并创建流（建议在外网环境下进行操作）
3.1 前期准备：
1）申请公测，并开通开天集成工作台 https://www.huaweicloud.com/product/mssi.html
2）准备API，或在华为云商店购买API https://marketplace.huaweicloud.com/markets/apaas/api.html
注：申请公测后，页面会跳转到开通工作台的界面，页面上如显示“您还没有开通集成工作台”属于正常跳转流程。
点击“立即开通”，输入所属行业和企业名称，账号正式开通集成工作台。
3.2 操作指导：
场景说明：在生活中，我们经常需要用到不同规格要求的证件照：白底红底蓝底、电子版打印版、1寸2寸……没有还得立马赶去照相馆，那我们能不能直接用手机拍摄照片，处理后作为证件照呢？
操作流程示意图：
第一步：购买API
1）进入华为云商店→搜索“证件照接口API”→购买，规格分别选择【证件照制作接口】、【证件照环境检测】，套餐包选择0元/60次。
证件照接口API地址：https://marketplace.huaweicloud.com/contents/c2a2724d-95fb-4c48-9d3b-a992b30e3965
2）购买成功后可以在云市场上买家中心获取AK/SK、查看使用情况、调试API等
a. 获取AK/SK
参考：什么是AK/SK? https://www.huaweicloud.com/zhishi/edits-15791060.html
b. 调试API
-
- 证件照制作接口
根据参考文档，填写请求体：
{ "type": "jpg", "spec": "1", "bk": "white", "photo":"图片base64"}
说明：导入源码时，请确认格式为json
参数说明：
Type：图片类型，支持“jpg”和“png”两种类型；
Spec：证件照规格ID，根据想要制作的证件照类型选择，spec为1表示制作1寸证件照，ID对应的证件照类型请在附件-证件照制作接口文档中查询。
Bk：颜色编码，证件照背景颜色的代码，bk为white表示制作白底证件照，请在附件-证件照制作接口文档中查询。
Photo：Base64编码是一种图片处理格式，通过特定的算法将图片编码成一长串字符串，在页面上显示的时候，可以用该字符串来代替图片的URL。附件中提供了4个图片base64编码，您也可以选择自己的图片，在线转换为base64编码。在线转换参考地址：https://c.runoob.com/front-end/59/
点击发送请求后，页面滑到最下方，右边可以看到，收到的响应体为：
ii. 证件照环境检测接口：
根据参考文档，填写请求体：
{“photo”: “图片base64编码”}
说明：图片base64 太长不方便显示，请用附件中提供的图片base64编码替换。
点击发送请求后，收到的响应体为：
对于有研发经验的小伙伴来说，创建连接器，可以直接编写OpenAPI文件，导入即可；对于非研发同学来说，则可以按下面的步骤一步步构建。
第二步：将购买的API创建成连接器
1）登录开天集成工作台管理控制台 https://console.huaweicloud.com/macroverse/ssi/?region=cn-north-4#/console/portal
2）进入连接器管理->我的连接器，点击创建我的连接器
3）先导入证件照制作API，根据商品详情内的信息填写连接器基本信息，填好后点击立即创建
说明：1、需要注意的是，由于这两个API的调用地址不同，
制作：https://idphoto.apistore.huaweicloud.com/idphoto/make
环境检测：https://envidphoto.apistore.huaweicloud.com/idphoto/env_detect
所以需要创建两次连接器，如果调用地址相同的话，只需要在一个连接器内创建多个执行动作就可以了。
2、云市场内购买的API直接选择AK/SK认证即可
协议和主机地址在对应API的商品详情中查看。
4）创建好连接器后，点击更多->创建执行动作
5）ID和动作名称自定义，选择下一步
注：ID中不能包含中文。
6）接口路径，请求方式选择POST，路径填写/idphoto/make
在第一步的调试API中，我们已经写好了请求体，点击导入源码，将请求体的代码复制过来，确定。
可以适当补充别名，作为流编排中的参数说明。将四个参数都勾选为必填项。
7）点击下一步，填写响应体，将调试制作证件照API中，收到的响应体复制过来，导入源码
{"status": 0, "time": 1207, "data": {"result":
"https://oapi.aisegment.com/static/photo/p2/20220624/apiresult/ee9/ee96269ff4494932beef441df62e755c.jpg", "size": [295, 413]}, "errmsg":
"SUCCESSFULLY", "error": ""}
8）执行动作创建完后，发布连接器。
说明：如果在保存执行动作后，还需要修改，则点击对应连接器的名称进入详情页，编辑执行动作。
连接器可以创建触发事件和执行动作：
- 触发事件：触发器从连接器读取数据。触发器关注发生的特定事件，例如正在创建的新联系人或订单，并提供相关数据，以便用户可以对该事件采取行动。
- 执行动作：通过定义执行动作确定用户可以执行的操作。操作可用于读取、创建、更新或删除对应服务中的资源。
9）下一步需要创建连接。
10）填写在第一步中获取到的AK/SK。AppKey就对应accessKey，AppSecret就对应secretAccessKey。
10）按照相同的步骤，创建证件照环境检测的连接器，导入环境检测API。
创建连接器。
创建执行动作。
导入请求体源码。
导入响应体源码。
创建连接。
第三步：根据场景创建流（注：输入参数时，如遇到网页停止运行或者保存请求超时的情况，请检查网络是否设置了上传拦截，建议切换至外网环境操作）
1）选择手动触发器，由于证件照制作API中有四个输入参数，所以我们先在手动触发器这里定义出来。
2）添加环境检测执行动作。
通过环境检测的成功返回示例可知，
如果环境通过检测，则“pass”为true且“reasons”数组长度为0，如果环境未通过检测，则“pass”为false且“reasons”返回失败原因。
这里我们条件放宽一点，只要失败原因少于等于两条，都继续制作证件照，多于两条则给用户发邮件，提示更换照片或者更换环境再次拍摄照片。
3）添加条件判断
选择函数中的length()函数，括号中选择动态内容中的reasons，条件选择小于等于2
4）在左边添加制作证件照的执行动作，并配置好参数。
添加发送邮件的执行动作，将成功制作的照片链接发送到自己的邮箱。
5）另一边，如果环境检测失败，则返回失败原因。
6）另保存后运行，如果成功，则邮件会收到照片链接：
如果失败，邮件会收到失败原因：
附件中提供两种结果的图片base64编码，用于测试。
附件：
1. 环境检测成功_图片base64编码（原图100k，适用于网络设置了上传拦截的情况）
2. 环境检测成功_图片base64编码（原图较大，适用于外网环境）
3. 环境检测失败_图片base64编码（原图100k，适用于网络设置了上传拦截的情况）
4. 环境检测失败_图片base64编码（原图较大，适用于外网环境）
进阶任务完成后，不要忘了来这里打卡哦~
打卡方式：完成进阶任务+运行日志截图
回帖如何添加图片？点击左侧的“回复”图标，文字框为快速回复，只能发送文字
有不明白的地方？希望加入开天aPaaS开发者社群？扫码添加华为云开天小助手~
活动总览-[活动总览]体验开天aPaaS集成工作台，挑战进阶任务赢华为手表！[进行中]
活动1-关注开天aPaaS论坛，开通集成工作台，10万码豆任你拿！[进行中]
活动2-【开天aPaaS工作台火热公测中】体验API新玩法，挑战进阶任务，赢华为Watch GT2！[进行中]
- 点赞
- 收藏
- 关注作者
评论（0）