对接模式整理

本文探讨了H5和API两种对接模式在业务中的应用,包括我司平台与供应商的交互过程,如支付、用户信息共享,以及如何通过微内核和插件化设计实现数据同步。以美团、奈雪等为例,详细解释了各自的对接流程和关键节点的处理策略。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

对接模式,根据交互方式区分分为 H5对接 和 api 对接两种方式。根据对接主体的不同分为供应商对接我司平台和我司对接供应商平台。

H5 方式供应商对接我司开放平台。
业务描述: 我司开放平台提供文档,把用户、订单、支付流程相关接口定义出来,提供给供应商对接。本质上是我司提供 支付 和 用户信息能力。供应商拿到 用户信息 和 支付信息,纳入己方体系,完成订单履约。有别于传统的 供应商提报商品+我司平台提供展示页面。

流程: 用户在我司首页入口点击后带 token 进入供应商 H5 ,在供应商页面选购下单,下单完成后跳转到我司收银台支付,支付完成后我司通知供应商。

关爱通地址: https://open.guanaitong.com/doc/seller/order-receipt-standard-v3/

H5 方式我司对接供应商开放平台。
业务描述: 比如对接美团外卖、美团旅游玩乐等,按照对方的文档进行用户、支付对接。本质也是我们提供支付能力,在确定支付后把支付信息同步给美团,让美团进行履约。

流程: 我司在跳转到 美团H5 之前,需要通过美团接口获取一个带登录态的 URL 跳转过去。然后订单支付之前,美团通过我司提供的一个下单接口获取收银台地址,然后跳转到这个收银台地址进行支付,支付完成后通知美团。

美团文档地址: https://h5.dianping.com/app/bep-docs/sky-doc/tradecenter/standardThird_payAccess_v3.html#_2-3-%E9%80%80%E6%AC%BE%E6%8E%A5%E5%8F%A3

API 对接供应商开放平台
业务描述: 一般对接 api 都是按照供应商的数据和流程进行对接,我司仿照供应商的流程画页面,然后流程和供应商保持有一致。基本上关键节点都是要实时同步的,这里需要保持和供应商的订单状态是一致的,不能只是我司单方面走流程,不然供应商没法履约。(H5对接可以先履约,后面同步数据)

流程: api 对接都是按照供应商的流程来的,基本可以参照供应商自己的app。而数据是根据运营要求来的,比如可以落商品数据、商家档案数据、地点档案数据,可以把供应商当作基础数据层,在供应商数据层之上加一层运营层,可以根据运营要求调整价格等属性。

奈雪文档地址:https://tm-cloud-doc.pin-dao.cn/index.html#/README

我司定义api流程让供应商对接(微内核+插件化)
业务描述: 如果是我司自己的履约系统、库存系统,在发生订单状态变更时,会把关键数据同步给供应商的 erp 系统,相当于我司定义关键节点和数据口径,同步给供应商。除了这种 erp 同步信息,异业一些业务简单的流程也可以这么做。比如话费充值,只需要供应商有相应接口,就可以纳入我司的话费充值流程,这种简单的商品我司不需要落库,只要在充值节点调用供应商接口同步即可。借鉴业界微内核+插件化的设计模式,我司定义话费充值内核,把供应商视作可以插播的插件。

流程: 我司定义话费充值流程,供应商按我司标准提供话费充值接口、订单查询接口、状态同步接口,

<think>好的,我现在需要处理用户关于钉钉审批模式API集成的问题。首先,用户想知道钉钉审批支持哪些模式,以及如何通过API对接实现功能集成。我需要根据提供的引用内容来整理答案,同时遵循之前的系统级指令,比如正确使用LaTeX格式,生成相关问题,并且添加引用标识。 首先,钉钉审批的模式可能包括表单设计、流程配置、消息通知等。根据引用[1][4],用户提到OA系统需要对接考勤审批用印申请,这说明钉钉审批支持自定义表单流程。另外,引用[4]中的演示案例提到报销单生成总账凭证,可能涉及数据同步到财务系统,这应该属于集成模式的一部分。 接下来,API对接方面,引用[1]提到钉钉能提供接口,引用[2][3]则具体描述了集成的步骤代码示例。比如引用[2]提到的三步配置,包括记录接口参数、字段映射方案设置,而引用[3]展示了如何通过本地存储处理token,这可能与API鉴权相关。需要详细说明如何调用钉钉的审批接口,比如发起审批、处理回调、同步数据等步骤。 另外,要注意用户可能需要具体的实现步骤,比如如何获取API权限,配置参数,处理回调等。同时,生成的代码示例要符合Python或其他常见语言的格式,确保语法正确。根据引用[3]中的代码,可能需要使用token进行身份验证,所以在示例中要体现这一点。 然后,生成的相关问题需要围绕钉钉审批的扩展应用、安全性、测试方法以及与其他系统的集成,比如引用[4]中的金蝶云星空案例,可以提问如何实现报销单生成凭证的问题。 最后,确保回答结构清晰,分点说明模式集成步骤,引用正确的位置,比如引用[1]关于接口支持,引用[2]关于三步配置,引用[3]关于token管理,引用[4]关于具体应用案例。同时,注意使用中文,避免使用Markdown格式,但代码块需要用反引号包裹。</think>### 钉钉审批模式API集成说明 #### 一、钉钉审批支持的模式 1. **自定义审批流程** 钉钉允许通过可视化表单设计器定义审批模板,例如请假、报销、用印申请等。流程支持多级审批、条件分支、消息通知等功能[^1][^4]。 2. **系统集成模式** 钉钉审批可与外部系统(如OA、ERP)对接,实现数据双向同步。例如,报销单审批通过后自动生成财务凭证(如引用[4]中金蝶云星空的案例)。 3. **API驱动模式** 通过开放接口实现自动化操作,包括发起审批、查询状态、回调通知等。例如,通过API将企业自建系统的数据推送至钉钉审批流[^1][^3]。 --- #### 二、通过API对接钉钉审批的步骤 1. **获取API权限** - 在钉钉开发者后台创建应用,启用“审批API”权限。 - 使用`CorpId``AppKey`生成访问令牌(Token),如引用[3]中的`localStorage`管理Token示例: ```javascript // Token管理示例 export function getToken() { return localStorage.getItem("token") as string; } ``` 2. **调用审批接口** - **发起审批实例**:调用`topapi/processinstance/create`接口,传入表单数据。 - **查询审批状态**:使用`topapi/processinstance/get`接口实时获取进度。 - **回调通知**:配置HTTP回调地址接收审批结果(如通过/拒绝)[^2]。 3. **数据字段映射** 根据业务需求配置钉钉审批表单与企业系统的字段对应关系。例如,将钉钉的“报销金额”映射至金蝶系统的“凭证金额”(引用[2]中的字段映射步骤)。 4. **异常处理与日志** 设置重试机制(如引用[2]提到的重试次数)日志监控,确保接口稳定性。 --- #### 三、代码示例(Python调用钉钉API) ```python import requests def create_approval_instance(token, form_data): url = "https://oapi.dingtalk.com/topapi/processinstance/create" headers = {"Content-Type": "application/json"} params = {"access_token": token} payload = { "process_code": "审批模板ID", "originator_user_id": "发起人ID", "form_component_values": form_data } response = requests.post(url, params=params, headers=headers, json=payload) return response.json() ``` --- #### 四、典型应用场景 1. **考勤审批对接**:OA系统调用钉钉接口同步请假、加班数据。 2. **财务报销集成**:钉钉审批通过后自动生成ERP凭证(如引用[4]的金蝶案例)。 3. **用印流程自动化**:审批结果触发电子签章系统操作[^2]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值