## 项目笔记 last update：2017-8-11 15:24:11 ### 术语介绍 - **corpid**：每个企业都拥有唯一的corpid，获取此信息可在管理后台“我的企业”－“企业信息”下查看（需要有管理员权限） - **secret**：secret是企业应用里面用于保障数据安全的“钥匙”，每一个应用都有一个独立的访问密钥，为了保证数据的安全，secret务必不能泄漏。通讯录接口的密钥在“管理工具”-“通讯录同步”里面查看，企业自定义的应用的密钥可以在企业应用的详情里面手动生成 - **access_token**：access_token是企业后台去企业微信的后台获取信息时的重要票据，由corpid和secret产生。所有接口在通信时都需要携带此信息用于验证接口的访问权限 -------- ### 笔记 corpid：每个企业都拥有唯一的corpid secret：应用的密匙，每一个应用都有一个独立的访问密钥 access_token：接口通信的令牌，需要注意的是，每个应用有独立的secret，所以每个应用的access_token应该分开来获取 ### 对access_token进行缓存处理： 获取的频率有限制：目前为2000次/天/应用 每个access_token的有效期为7200秒（2小时） 由于企业微信每个应用的access_token是彼此独立的，所以进行缓存时需要区分应用来进行存储。 ------ ### 接口注意： - 企业微信的所有接口都会返回errmsg和errcode，所以在判断是否成功时不能以判断是否存在此字段为依据。 - 企业微信的访问凭证更长，请保留足够的长度，至少为512字节。 - 企业微信每个自建应用对应一个密钥 - 有部分接口在细节处有所差异，详见以下部分。 ### 通讯录同步助手 其实它也是一个应用，不过这个是内置的应用，开启后，它也会有一个secret，所以它也会得到一个所属它的access_token。 这样也就不难理解这句话了：在通讯录同步助手中此接口可以读取企业通讯录的所有成员信息，而企业自定义的应用可以读取该应用设置的可见范围内的成员信息。 思考企业微信，系统，学校后台之间的关系？ 企业微信提供了OAuth的授权登录方式，可以让网页和企业微信共享用户ID，从而免去登录的环节。 管理企业应用 ========== 应用管理 1. 获取应用 参数： |参数|必须|说明| |access_token| 是| 调用接口凭证| |agentid | 是| 授权方应用id| 权限说明： 企业仅可获取当前凭证对应的应用；第三方仅可获取被授权的应用。 2. 设置应用 权限说明： 企业仅可设置当前凭证对应的应用；第三方仅可设置被授权且非主页型的应用。 说明：设置不是创建，设置时更新操作，需要传应用ID参数。 >[info] 没有创建企业应用的接口，需要自己登录企业管理后台创建应用。 3. 获取应用概况列表 参数： |参数|必须|说明| |access_token| 是| 调用接口凭证| 权限说明： 企业仅可获取当前凭证对应的应用；第三方仅可获取被授权的应用。 返回应用列表，但是有个问题，既然access_token是每个应用独有的，那么这里这个access_token是哪个的呢？ 猜想1：其实只要是满足条件的任何一个都可以，验证时是遍历的？ 猜想2：使用“通讯录应用”的access_token ---------------------- ### 操作记录 点关注验证的卡片，输手机号码，提示未在学校注册，点击下面加入班级后，又可以收到腾讯的关注验证码了，然后就关注了。 关注之后就显示 了其它的应用了（这实现的方式就是应用的可见范围，这是把我加入了企业成员啊，可我只是个普通的家长啊，还是出现了上面担心的问题了。我只是使用这个应用而已，不是要成为你学校企业的内部成员啊，企业人数有上限怎么办，一个学校要是上万人，并且每年都增加，把家长加到企业成员上肯定是不行的啊！！！） Q: ss那边加入班级，加入家长，填写手机号码159的，竟然是s这个号收到通知了，看来绑定手机号码的微信收到通知了。ss这个微信只相当于一个浏览器一样。 A: 跟微信绑定手机没有任何关系的，之所以ss小天使操作，输入159加入，s收到通知的原因是因为，s已经成功关注了小天使，并且关注时输入的手机号码是159，这说明小天使里面有一个成员和s微信是绑定的，而此成员的手机号码就是159的。 Q: 159那边有企业应用，但是登陆安卓企业微信，看不到小天使的企业啊，证明我不是小天使的成员啊，但是又为什么种种迹象表明，s是小天使的成员啊，荒唐！不是说了成员才可以加入企业吗？ A: 是成员，可以切换企业的。 ----------------------- ### 能龙 后台分析 能龙的学生不算用户（因为学生不是使用者对象），学生需要在后台手动添加，然后家长关联的时候，输入 学生名字[爸爸/妈妈/家长]，就能自动关联学生。 家长前台加入时，如果输入的学生名称不存在，那么就会自动创建一个学生。 既然是通过学生名称来关联家长的，那么一个班级里面如果发生学生名称重复会怎么样呢？ 答案是无法添加学生，提示“孩子姓名在班内重名”，那么此时就要想办法了，比如小明大，小明小 ** 出现重名时，那家长前台加入班级时怎么办呢？ ** 就会出现关联错了小孩，关联到别的小朋友去了。 ！！！！这种方式并不好，最好是，用学号，或者每个学生有一个唯一的二维码，家长直接扫描关联就好了。 ------------ ### 企业微信与微信的关系 企业微信和微信没有本质关系，通常所说的微信号是指微信用户账号，微信号可绑定作为企业微信的管理员。 ### 企业微信成员是什么？和微信账号有什么关系？ 企业成员账号是微信企业内的成员账号，账号是成员在企业内的唯一标识，使用工号、手机号、邮箱等公司系统内统一的ID来标示成员的唯一性，和微信账号没有关系，是彼此独立分割的。 成员的账号，工号、手机号、邮箱是唯一的字段，要保持唯一性。 参考：https://kf.qq.com/faq/170104MryQB7170104vqiaYn.html ### 微信插件 微信插件就像公众号一样，是一个二维码，用户扫描关注后会出现在联系人列表，企业号列表下，点进去就是企业号设置的应用列表了。这是普通微信上面的体验，一般人也是这么使用企业微信提供的服务的，但是有一个问题，必须要企业成员才能关注微信插件，这就蛋疼了。这样意味着企业微信的服务能力只能服务于企业成员，这与家校平台的模式不合，明显是不行的！ 是企业成员在微信客户端连接、使用企业微信的桥梁。 [微信插件](https://kf.qq.com/product/qyweixin.html?scene_id=pc349#hid=2371) ### 问题 -- ！！！！！ 有一个重要的问题，关注微信插件的人，必须是企业成员才可以吗？那这样就完了，很明显这些家长，学生不是企业的成员，不能算到企业通讯录里面去，并且企业微信的成员人数肯定是有上限的，所以这肯定行不通的 ！！！！！ 企业人员上限是：30000（3万人） ### 猜想 企业微信的账号和微信账号是两个东西，但是如果企业微信的账号手机号码，绑定了微信账号，那么想必会关联吧。 * * * * * ## 临时记录 http://kf.qq.com/faq/120911VrYVrA150922UvaQfa.html http://zhidao.baidu.com/link?url=0eBvkGIvvrw0M-Qh31nX1_lHQHdShEXL0_Dea6pE8AGMkA8va77i1l4oDXlF4CnRYYsQWD4qGWHAVgmDzqGOimcdyX2axYkuQaQsdAXAhZ7