【开天aPaaS工作台火热公测中】3-进阶任务操作指导:创建连接器并创建流

举报
开天aPaaS小助手 发表于 2022/06/06 11:02:11 2022/06/06
【摘要】 【3-进阶任务操作教程】创建连接器并创建流。挑战3重任务,玩转API,华为手表Watch GT2、华为音箱等好礼等着您~

3. 进阶任务-创建连接器并创建流(建议在外网环境下进行操作)

3.1 前期准备:

       1)申请公测,并开通开天集成工作台 https://www.huaweicloud.cn/product/mssi.html

       2)准备API,或在华为云商店购买API https://marketplace.huaweicloud.cn/markets/apaas/api.html

注:申请公测后,页面会跳转到开通工作台的界面,页面上如显示“您还没有开通集成工作台”属于正常跳转流程。

      点击“立即开通”,输入所属行业和企业名称,账号正式开通集成工作台。

3.2 操作指导:

       场景说明:在生活中,我们经常需要用到不同规格要求的证件照:白底红底蓝底、电子版打印版、1寸2寸……没有还得立马赶去照相馆,那我们能不能直接用手机拍摄照片,处理后作为证件照呢?


操作流程示意图:

1-2.png

第一步:购买API

       1)进入华为云商店搜索证件照接口API”→购买,规格分别选择【证件照制作接口】、【证件照环境检测】,套餐包选择0/60次。

证件照接口API地址:https://marketplace.huaweicloud.cn/contents/c2a2724d-95fb-4c48-9d3b-a992b30e3965


2.png

       2)购买成功后可以在云市场上买家中心获取AK/SK、查看使用情况、调试API


买家中心:https://console.huaweicloud.cn/marketplace/tenant/?region=cn-north-4&locale=zh-cn#/market/order/purchasedProducts

             a. 获取AK/SK

              参考:什么是AK/SK?  https://www.huaweicloud.cn/zhishi/edits-15791060.html


3.jpg

4.png

             b. 调试API

    1. 证件照制作接口

             根据参考文档,填写请求体:

             { "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/

5.png

点击发送请求后,页面滑到最下方,右边可以看到,收到的响应体为:

6.png

             ii. 证件照环境检测接口:

             根据参考文档,填写请求体:

             {“photo”: “图片base64编码”}

           说明:图片base64 太长不方便显示,请用附件中提供的图片base64编码替换。


7.png

点击发送请求后,收到的响应体为:



8.png



对于有研发经验的小伙伴来说,创建连接器,可以直接编写OpenAPI文件,导入即可;对于非研发同学来说,则可以按下面的步骤一步步构建。

 

第二步:将购买的API创建成连接器

       1)登录开天集成工作台管理控制台 https://console.huaweicloud.cn/macroverse/ssi/?region=cn-north-4#/console/portal

       2)进入连接器管理->我的连接器,点击创建我的连接器

2-4.png

       3)先导入证件照制作API,根据商品详情内的信息填写连接器基本信息,填好后点击立即创建

       说明:1、需要注意的是,由于这两个API的调用地址不同,

       制作:https://idphoto.apistore.huaweicloud.cn/idphoto/make

       环境检测:https://envidphoto.apistore.huaweicloud.cn/idphoto/env_detect

       所以需要创建两次连接器,如果调用地址相同的话,只需要在一个连接器内创建多个执行动作就可以了。

       2、云市场内购买的API直接选择AK/SK认证即可

2-5-1.png

       协议和主机地址在对应API的商品详情中查看。

2-5-2q.png

        4)创建好连接器后,点击更多->创建执行动作

2-6q.png

       5)ID和动作名称自定义,选择下一步

       注:ID中不能包含中文。

2-7q.png

       6)接口路径,请求方式选择POST,路径填写/idphoto/make

       在第一步的调试API中,我们已经写好了请求体,点击导入源码,将请求体的代码复制过来,确定。

替换20220630-103928(WeLinkPC).png

可以适当补充别名,作为流编排中的参数说明。将四个参数都勾选为必填项。

10.png

       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": ""}


11.png

       8)执行动作创建完后,发布连接器。

12.png

说明:如果在保存执行动作后,还需要修改,则点击对应连接器的名称进入详情页,编辑执行动作。

13.png

      连接器可以创建触发事件和执行动作:

  • 触发事件:触发器从连接器读取数据。触发器关注发生的特定事件,例如正在创建的新联系人或订单,并提供相关数据,以便用户可以对该事件采取行动。
  • 执行动作:通过定义执行动作确定用户可以执行的操作。操作可用于读取、创建、更新或删除对应服务中的资源。

       9)下一步需要创建连接。

3-2-11.png

       10)填写在第一步中获取到的AK/SK。AppKey就对应accessKeyAppSecret就对应secretAccessKey

3-2-12-1.png

       10)按照相同的步骤,创建证件照环境检测的连接器,导入环境检测API

       创建连接器。

3-2-13-1.png

       创建执行动作。

3-2-13-2.png

       导入请求体源码

15.png

       导入响应体源码

16.png

       创建连接。

3-2-13-5.png

 

第三步:根据场景创建流(注:输入参数时,如遇到网页停止运行或者保存请求超时的情况,请检查网络是否设置了上传拦截,建议切换至外网环境操作)

       1)选择手动触发器,由于证件照制作API中有四个输入参数,所以我们先在手动触发器这里定义出来。


17.png

       2)添加环境检测执行动作。

18.png

通过环境检测的成功返回示例可知,

如果环境通过检测,则“pass”为true且“reasons”数组长度为0,如果环境未通过检测,则“pass”为false且“reasons”返回失败原因。

这里我们条件放宽一点,只要失败原因少于等于两条,都继续制作证件照,多于两条则给用户发邮件,提示更换照片或者更换环境再次拍摄照片。

       3)添加条件判断

19.png

选择函数中的length()函数,括号中选择动态内容中的reasons,条件选择小于等于2

20.png

21.png

22.png

       4)在左边添加制作证件照的执行动作,并配置好参数。


23.png

添加发送邮件的执行动作,将成功制作的照片链接发送到自己的邮箱。



24.png


       5)另一边,如果环境检测失败,则返回失败原因。

25.png

       6)另保存后运行,如果成功,则邮件会收到照片链接:

26.png

如果失败,邮件会收到失败原因:

27.png

        附件中提供两种结果的图片base64编码,用于测试。

附件:

1. 环境检测成功_图片base64编码(原图100k,适用于网络设置了上传拦截的情况)

2. 环境检测成功_图片base64编码(原图较大,适用于外网环境)

3. 环境检测失败_图片base64编码(原图100k,适用于网络设置了上传拦截的情况)

4. 环境检测失败_图片base64编码(原图较大,适用于外网环境)

 

进阶任务完成后,不要忘了来这里打卡~

打卡方式:完成进阶任务+运行日志截图

流运行日志截图.png

回帖如何添加图片?点击左侧的“回复”图标,文字框为快速回复,只能发送文字


论坛回复.PNG

有不明白的地方?希望加入开天aPaaS开发者社群?扫码添加华为云开天小助手~

小助手二维码.jpg

活动总览-[活动总览]体验开天aPaaS集成工作台,挑战进阶任务赢华为手表![进行中]

活动1-关注开天aPaaS论坛,开通集成工作台,10万码豆任你拿![进行中]

活动2-【开天aPaaS工作台火热公测中】体验API新玩法,挑战进阶任务,赢华为Watch GT2![进行中]

活动3-【开天aPaaS分享有礼】讲体验、提建议,赢华为AI迷你音箱等好礼![进行中]

活动4-【有奖征文 第14期】开发者集结!体验开天aPaaS平台,赢智能安防家庭套装 [进行中]

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。