POST/memberContacts/addMemberContactsH5小程序

添加联系人

会员 / 常用联系人· MemberContactsController#addMemberContacts

基本信息

接口状态脚手架生成·未接入前端置信度中
接口URLPOSThttps://dscp-dev.hn12301.net/h5-api/memberContacts/addMemberContacts
请求方式POST
Content-Typeapplication/json
暴露渠道H5、小程序　前缀 /h5-api
名称来源源码注释
调用方本次扫描未发现调用　不等于可以下线
需求上下文常用联系人管咯模块接口开发
维护人 / 最后改动luoli　2024-04-17　最近提交：常用联系人管咯模块接口开发
读写数据表member_contacts　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.member.MemberContactsController#addMemberContacts
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/member/MemberContactsController.java:86
判定依据控制器由代码生成器产出（@author Chaos-Toolkits），整套 CRUD 接口但前端无调用

请求参数

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 MemberContactsAddRequest

参数名	参数值	是否必填	参数类型	描述说明
name	…	是	String	姓名 → member_contacts.name
phone	…	是	String	手机号码 → member_contacts.phone
idType	…	是	IdType	卡种等级IdType，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证 → member_contacts.id_type 1＝身份证 2＝护照 3＝港澳居民来往内地通行证 5＝驾驶证 6＝居住证 7＝士官证 8＝学生证
identityNo	…	是	String	身份证 → member_contacts.identity_no
facePhoto	…	否	String	人脸照片 → member_contacts.face_photo

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

参数名	参数值	是否必填	参数类型	描述说明
void —— 不返回业务数据（外层包装见全局公共参数）

响应示例

成功响应示例 code=0

{"errcode":0,"errmsg":""}

失败响应示例

{
  "data": null,
  "可能返回": [
    {
      "errcode": "99999",
      "errmsg": "服务内部错误"
    },
    {
      "errcode": "20003",
      "errmsg": "上传人脸错误"
    }
  ]
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：member_contacts　反查全部引用接口 →

MemberContactsController#addMemberContacts
TencentVerifyFaceService#searchFaces
TencentVerifyFaceService#deletePerson
TencentVerifyFaceService#createPerson
SessionMemberService#getSessionId
BeanUtils.map → MemberContacts ⇒ 表 member_contacts

其它依赖：TencentVerifyFaceService.searchFaces、TencentVerifyFaceService.deletePerson、TencentVerifyFaceService.createPerson、SessionMemberService.getSessionId

逻辑摘要：查询详情（memberContactsService.get）；调用 isNotEmpty（StrUtil.isNotEmpty）；调用 searchFaces（tencentVerifyFaceService.searchFaces）；入参与返回值经 BeanUtils 做对象/分页映射

操作日志：member / 添加联系人

源码内联注释（旧站解析结果）

数据库人脸id
根据人脸url地址查询人脸
如果有人脸信息
先删除人脸信息
录入人脸
用户姓名
人像图片地址
人员ID不可重复

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

可能抛出的业务码：99999 服务内部错误、20003 上传人脸错误　错误码字典 →