本篇介绍了通过POA接入事务服务,如何调用事务接口实现待办创建、完成等流程。
# 接入流程简介
第一步:注册poa,获取接口权限和访问凭证。
第二步:在事务服务中注册应用,以获取使用事务接口能力的权限。
第三步:在注册的应用下添加事务类型,在调用事务服务时使用。
第四步:调用事务相关API。
# 第一步 注册开放平台并申请权限与访问凭证
POA(全称:platform open api),主要是方便开放性的api管理共享,消息、事务基础能力接口都注册到POA中,可以通过POA调用消息、事务接口。
POA介绍与申请请参考POA介绍
# 第二步 开通事务服务
在事务服务中注册应用,获得appid(唯一身份标识),在后续接口调用时做身份鉴定使用。
管理员登录云平台,进入事务服务-应用管理中创建应用。
应用创建成功后,进入应用可以查看应用的Appid(唯一身份标识)。
# 第三步 创建事务类型
事务类型是事务场景的抽象,在事务类型中可以配置消息通知、批量办理等,并且在统计分析时能够作为一项依据。
业务方在平台发起事务时,需要用到事务类型,有以下两种方式:
提前场景事务类型,在发起事务时使用已创建的事务类型。
无需提前创建事务类型,在发起事务时自动创建事务类型。使用这种方式,业务方应该保证每次发起相同类型的事务时,使用同一个事务类型ID,避免重复创建事务类型。
能力开通后,开发者在事务中心创建事务类型。
# 第四步 调用事务相关API
平台为事务能力接入提供两套接口能力,分别适用于简单的业务场景和复杂(流程类)的业务场景,业务方根据实际业务情况进行选择。
API | 描述 | 示例 |
---|---|---|
简单事务 (V1.3.1及以上) | 简单的业务,通常需要一人或多人完成相同的待办,如志愿填报、活动报名等。 | API调用示例 |
流程事务 | 复杂的流程类业务,需要完成多条待办,待办之间存在如串行、并行的关联关系,如入职面试、费用报销等审批流程。 | API调用示例 |
← 接入教程(使用开放平台) 调用示例 →