APP开发如何对接小程序和后台?
结论:APP、小程序和管理后台应围绕同一套业务规则与指定数据源对接,前端按各自交互调用服务。先明确数据维护方、操作权限、状态和接口契约,再验证跨端结果、重复请求及旧版本兼容;共用后台不代表共用登录凭证,也不要求各端功能完全相同。
APP、小程序和管理后台可以共用业务服务,让同一预约、工单或会员权益在不同端保持一致。端别可以有不同页面与能力,但业务编号、状态含义和操作结果应能对应。对接前要明确谁维护数据、谁能发起操作、结果以哪里为准,再设计接口;不能只把三个端连接到数据库就认为完成打通。
先给每类数据指定维护方和可执行动作
建议整理一份清单,逐行写业务对象、编号、维护系统、可读端、可写角色、允许动作和同步时机。商品或客户资料已有系统负责时,由该系统提供数据;各端只在授权范围查询或提交业务动作。共用能力不要求所有数据放进同一个库,也不要求给APP用户开放管理后台的编辑权限。
- 身份关系:由可信后端把端内登录映射到业务用户,用户账号与员工后台账号分别授权;不要凭客户端传入的会员编号决定可见数据。绑定与换号细节见APP用户账号体系。
- 业务状态:为提交、受理、取消等动作指定服务和状态规则,两端读取同一处理结果,后台人工操作也保留责任人与记录。
- 端能力差异:相机、通知或离线入口按各端能力适配,服务端规则保持一致;某端暂不提供的操作应说明处理入口。
接口契约要覆盖上线后仍在用的旧APP
接口资料应写请求字段、必填与枚举、返回状态、权限校验、错误码、超时处理、请求编号及版本兼容约定。新增状态不能只改后台和小程序:旧APP遇到不认识的状态应有明确展示与受限操作办法。破坏兼容的调整需约定版本切换、支持范围与恢复安排,并保留可用于联调的测试账号和脱敏样例。
现有接口若含义不清或无法确认维护责任,先整理映射和联调条件。对接外部ERP时可另参考ERP接口准备资料;本文不以多端共用服务替代对外部系统的授权。
用同一业务编号检查跨端结果
示例:客户在小程序提交预约,在APP查看,员工从后台调整处理状态。联调记录可包含预约编号、发起端、角色、请求编号、状态版本、处理结果与时间。这是验收材料示例,不是实际项目测试记录。
- 走正常路径:小程序提交后,APP和有权限的后台人员能查询同一记录,字段与状态口径一致;界面存在延迟时按约定刷新或同步时机核对。
- 走关键冲突:后台已取消预约,旧APP仍拿着先前状态提交修改,服务端应拒绝过期操作或要求重新确认,并返回当前结果。
- 模拟提交超时:客户端先按请求编号回查,重试遵守接口去重约定,不能直接新建另一张预约;记录失败原因和人工处理入口。
身份无法可靠对应、同一对象有多个互相覆盖的数据源,或旧版本处理规则未约定时,应先关闭这些缺口,再扩大联调。完整范围可结合APP定制开发确定;是否值得增加第二个端,另按使用场景评估。
说明:本文为通用多端系统对接建议,接口、权限、同步时效、版本支持和验收范围以双方确认的需求说明与合同为准。