- 修正开发者、小程序和企业相关API的基础URL,避免重复添加/api前缀 - 统一调整developer、enterprise、invite等模块接口路径,保持与后端Controller一致 - 新增权限申请及消息通知相关API,并完善相关函数实现 - 规范请求参数传递,移除多余包装,改用直接传递对象方式 - 新增API Key重置、版本发布/回滚等接口支持 feat(invite): 重构邀请登录流程支持未注册快速加入 - 完整重写invite页,分离已注册用户和未注册用户的按钮显示和交互 - 实现未注册用户微信手机号授权后自动注册登录及自动加入应用 - 已注册用户直接确认加入应用,无需手机号授权弹窗 - 统一使用getPhoneNumber按钮处理两种状态并修复“授权码不能为空”报错 - 前端配合后端改造,支持已登录用户可直接通过Authorization头加入应用 fix(developer): 修复开发者中心应用加载问题 - 修复只查询创建的应用导致邀请加入的应用不显示的问题 - 同时请求创建应用和参与应用接口,合并并去重应用列表 - 新增pageJoinedApp接口调用及合并逻辑,提高应用列表完整性和体验
3.5 KiB
3.5 KiB
2026-04-13 工作日志
完成的工作
1. 阿里云实人认证接入
目的:为 user/userVerify 页面添加阿里云身份证二要素核验
后端改动(JAVA/websopy-java):
- pom.xml:添加
com.aliyun:cloudauth20190307:2.2.4依赖 - application.yml:添加
cloudauth配置项(accessKeyId、accessKeySecret、endpoint、regionId) - 新增
CloudAuthProperties.java:配置属性类 - 新增
IdVerificationService.java:实人认证服务 - 新增
IdVerificationController.java:实人认证 API 控制器
前端改动(VUE/websopy-mp):
- api/system/userVerify/index.ts:添加
verifyIdCard()API 调用 - user/userVerify/index.tsx:
- 导入 verifyIdCard
- 修改 submitSucceed 函数:个人认证时先调用实名校验,核验通过后再提交
2. 调研结论
- 城市服务实名校验:已于2021年11月停止开放,不可用
- 阿里云实人认证:推荐方案,0.2元/次,有100次免费试用额度
- 接入方式:身份证二要素核验(姓名+身份证号)最简单
待办事项
- 配置阿里云 AccessKey(在 application-prod.yml 中设置 cloudauth.accessKeyId 和 cloudauth.accessKeySecret)
- 在阿里云实人认证控制台开通服务并充值
- 测试验证接口是否正常工作
阿里云 AccessKey 配置
- 项目:websopy-java
- 文件:application-prod.yml
- accessKeyId: LTAI4GKGZ9Z2Z8JZ77c3GNZP
- 备注:与 OSS 使用同一个 AccessKey
3. 前端接口地址修正
目的:修正小程序端开发者相关 API 接口地址,与后端 Controller 路径保持一致
问题发现:BaseUrl 配置已包含 /api 后缀 (https://websopy-api.websoft.top/api),前端代码中不应再重复添加 /api 前缀,否则会导致 /api/api/ 路径错误。
修正文件:
-
src/api/developer/enterprise.ts:- 企业信息:
/system/tenant/info,/system/tenant - 企业成员:
/system/user/page,/system/user - 订单:
/system/order/page,/system/order - 账单:
/sys/recharge-order/page - 企业应用:
/app/product/page - 邀请:
/app/developer/invite
- 企业信息:
-
src/api/developer/developer.ts:- 项目/应用:
/app/product/*(create, update, delete, detail, page, my/page, joined/page) - API Key:
/app/app-credential/* - 版本发布:
/app/app-version/* - 开发者信息:
/app/developer/git-account,/app/developer/gitea-info - 通知:
/app/notification/* - 权限申请:
/app/developer/permission-requests/*
- 项目/应用:
-
src/api/invite/index.ts:- 所有接口移除
/api前缀
- 所有接口移除
后端 Controller 对应关系:
| 前端 API | 后端 Controller | 路径前缀 |
|---|---|---|
| enterprise.ts | TenantController | /api/system/tenant |
| enterprise.ts | UserController | /api/system/user |
| enterprise.ts | OrderController | /api/system/order |
| enterprise.ts | RechargeOrderController | /api/sys/recharge-order |
| developer.ts | AppProductController | /api/app/product |
| developer.ts | AppCredentialController | /api/app/app-credential |
| developer.ts | AppVersionController | /api/app/app-version |
| developer.ts | GitAccountController | /api/app/developer |
| developer.ts | AppNotificationController | /api/app/notification |
| developer.ts | AppPermissionRequestController | /api/app/developer/permission-requests |
| invite/index.ts | - | /api/invite/* |
重要配置:config/env.ts 中 API_BASE_URL 已包含 /api 后缀,前端代码路径不应再以 /api 开头。