## 項目筆記 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