因企微接口变更, 2022年8月后的用户只能通过企微新接口实现同步, 而新接口有诸多限制, 同步工具也做了相应改动,详情可以参考https://wenku.my7c.com/article/380026498914293504 本文主要是说明在新的接口条件, 企微不再直接返回除姓名外的用户信息的情况下, 同步工具是如何实现EAS职员和企微职员间绑定关系的. ## 接口说明 因为企微的接口限制(去年8月修改的), 我们没有办法同时批量获取到用户的id和手机号, 无法通过传统的手机号和姓名判断绑定关系; 现存的接口有: A. 获取部门成员详情: /cgi-bin/user/list 可以获取一个部门下的所有用户,但不能获取敏感信息字段 B. 创建成员: /cgi-bin/user/create 新增用户,若手机号或邮箱已存在,会返回对应提示信息和错误码 C. 手机号获取userid: /cgi-bin/user/getuserid 通过手机号获取企微userid D. 邮箱获取userid: /cgi-bin/user/get_userid_by_email 通过邮箱获取企微userid ## 同步步骤 1. 首先,通过接口A(获取部门详情), 并将数据更新到企微用户表; 2. 现有的绑定逻辑在新增用户里, 所有未绑定用户都会调用新增用户接口, 也就是说最初同步所有用户都会调用新增用户接口B; 3. 如果新增成功, 企微接口会返回userid, 则直接更新中间表的FXTID字段, 绑定成功; 4. 如果新增失败, 通过企微返回的信息判断, 如果是手机号重复(错误码60104)或者邮箱重复(60106), 就通过企微接口C或D, 以手机号或者邮箱获取到对应的userid, 实现绑定 5. 若是其他的错误码,则根据提示记录, 需要用户调整错误数据 引用:企微接口文档: 企微_开发者中心_服务端API