欧美成人精品手机在线观看_69视频国产_动漫精品第一页_日韩中文字幕网 - 日本欧美一区二区

LOGO OA教程 ERP教程 模切知識交流 PMS教程 CRM教程 開發文檔 其他文檔  
 
網站管理員

微信企業號開發之如何管理通訊錄(1)
admin
2014年12月2日 0:47 本文熱度 6798




文章簡介：企業號通訊錄具備完全開放的接口，你的應用可以調用這些接口管理部門、成員和標簽。你的應用也可以使用部門、成員、標簽發消息，或更改應用的可見范圍。

企業號通訊錄具備完全開放的接口，你的應用可以調用這些接口管理部門、成員和標簽。


你的應用也可以使用部門、成員、標簽發消息，或更改應用的可見范圍。


注意，每個部門的直屬員工上限為1000個；出于安全考慮，某些接口需要在管理端有明確的授權。


一、管理部門


1、創建部門



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN


請求包結構體為:

  1. { 
  2.    "name": "郵箱產品組", 
  3.    "parentid": "1" 
  4. } 


  • 參數說明


















參數 必須 說明
access_token 是 調用接口憑證
name 是 部門名稱。長度限制為1~64個字符
parentid 是 父親部門id。根部門id為1


  • 權限說明

管理員須擁有“操作通訊錄”的接口權限，以及父部門的管理權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "created", 
    4.    "id": 2 
    5. } 














參數 說明
errcode 返回碼
errmsg 對返回碼的文本描述內容
id 創建的部門id。

2、更新部門



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/department/update?access_token=ACCESS_TOKEN


請求包結構體為（如果非必須的字段未指定，則不更新該字段之前的設置值）:

  1. { 
  2.    "id": 2, 
  3.    "name": "郵箱產品部" 
  4. } 


  • 參數說明


















參數 必須 說明
access_token 是 調用接口憑證
id 是 部門id。
name 否 更新的部門名稱。長度限制為0~64個字符。修改部門名稱時指定該參數


  • 權限說明

管理員須擁有“操作通訊錄”的接口權限，以及該部門的管理權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "updated" 
    4. } 

3、刪除部門



  • 請求說明

Https請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/department/delete?access_token=ACCESS_TOKEN&id=1&id=2



  • 參數說明














參數 必須 說明
access_token 是 調用接口憑證
id 是 部門id。（注：不能刪除根部門；不能刪除含有子部門、成員的部門）


  • 權限說明

管理員須擁有“操作通訊錄”的接口權限，以及該部門的管理權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "deleted" 
    4. } 

4、獲取部門列表



  • 請求說明

Https請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=ACCESS_TOKEN



  • 參數說明










參數 必須 說明
access_token 是 調用接口憑證


  • 權限說明

管理員須擁有’獲取部門列表’的接口權限，以及對部門的查看權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "department": [ 
    5.        { 
    6.            "id": 1, 
    7.            "name": "廣州研發中心", 
    8.            "parentid": 0 
    9.        }, 
    10.        { 
    11.            "id": 2 
    12.            "name": "郵箱產品部", 
    13.            "parentid": 1 
    14.        } 
    15.    ] 
    16. } 























參數 說明
errcode 返回碼
errmsg 對返回碼的文本描述內容
department 部門列表數據
id 部門id
name 部門名稱
parentid 父親部門id。根部門為1



二、管理成員


1、創建成員



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token=ACCESS_TOKEN


請求包結構體為:

  1. { 
  2.    "userid": "zhangsan", 
  3.    "name": "張三", 
  4.    "department": [1, 2], 
  5.    "position": "產品經理", 
  6.    "mobile": "15913215421", 
  7.    "gender": 1, 
  8.    "tel": "62394", 
  9.    "email": "zhangsan@gzdev.com", 
  10.    "weixinid": "zhangsan4dev" 
  11. } 


  • 參數說明














































參數 必須 說明
access_token 是 調用接口憑證
userid 是 員工UserID。對應管理端的帳號，企業內必須唯一
name 是 成員名稱。長度為1~64個字符
department 否 成員所屬部門id列表。注意，每個部門的直屬員工上限為1000個
position 否 職位信息。長度為0~64個字符
mobile 否 手機號碼。企業內必須唯一，mobile/weixinid/email三者不能同時為空
gender 否 性別。gender=0表示男，=1表示女。默認gender=0
tel 否 辦公電話。長度為0~64個字符
email 否 郵箱。長度為0~64個字符。企業內必須唯一
weixinid 否 微信號。企業內必須唯一


  • 權限說明

管理員須擁有“操作通訊錄”的接口權限，以及指定部門的管理權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "created" 
    4. } 

2、更新成員



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token=ACCESS_TOKEN


請求包示例如下（如果非必須的字段未指定，則不更新該字段之前的設置值）:

  1. { 
  2.    "userid": "zhangsan", 
  3.    "name": "李四", 
  4.    "department": [1], 
  5.    "position": "后臺工程師", 
  6.    "mobile": "15913215421", 
  7.    "gender": 1, 
  8.    "tel": "62394", 
  9.    "email": "zhangsan@gzdev.com", 
  10.    "weixinid": "lisifordev", 
  11.    "enable": 1 
  12. } 


  • 參數說明


















































參數 必須 說明
access_token 是 調用接口憑證
userid 是 員工UserID。對應管理端的帳號，企業內必須唯一
name 否 成員名稱。長度為0~64個字符
department 否 成員所屬部門id列表。注意，每個部門的直屬員工上限為1000個
position 否 職位信息。長度為0~64個字符
mobile 否 手機號碼。企業內必須唯一，更新后的成員mobile/weixinid/email三者不能同時為空
gender 否 性別。gender=0表示男，=1表示女。默認gender=0
tel 否 辦公電話。長度為0~64個字符。必須企業內唯一
email 否 郵箱。長度為0~64個字符。企業內必須唯一
weixinid 否 微信號。企業內必須唯一
enable 否 啟用/禁用成員。1表示啟用成員，0表示禁用成員


  • 權限說明

管理員須擁有“操作通訊錄”的接口權限，以及指定部門、成員的管理權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "updated" 
    4. } 

3、刪除成員



  • 請求說明

Https請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/user/delete?access_token=ACCESS_TOKEN&userid=lisi



  • 參數說明














參數 必須 說明
access_token 是 調用接口憑證
userid 是 員工UserID。對應管理端的帳號


  • 權限說明

管理員須擁有“操作通訊錄”的接口權限，以及指定部門、成員的管理權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "deleted" 
    4. } 

4、獲取成員



  • 請求說明

Https請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&userid=lisi



  • 參數說明














參數 必須 說明
access_token 是 調用接口憑證
userid 是 員工UserID


  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "userid": "zhangsan", 
    5.    "name": "李四", 
    6.    "department": [1, 2], 
    7.    "position": "后臺工程師", 
    8.    "mobile": "15913215421", 
    9.    "gender": 1, 
    10.    "tel": "62394", 
    11.    "email": "zhangsan@gzdev.com", 
    12.    "weixinid": "lisifordev",   
    13.    "avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0", 
    14.    "status": 1 
    15. } 












































參數 說明
errcode 返回碼
errmsg 對返回碼的文本描述內容
userid 員工UserID
name 成員名稱
department 成員所屬部門id列表
position 職位信息
mobile 手機號碼
gender 性別。gender=0表示男，=1表示女
tel 辦公電話
email 郵箱
weixinid 微信號
avatar 頭像url。注：如果要獲取小圖將url最后的"/0"改成"/64"即可
status 關注狀態: 1=已關注，2=已凍結，4=未關注


  • 權限說明

管理員須擁有’獲取成員’的接口權限，以及成員的查看權限。


5、獲取部門成員



  • 請求說明

Https請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=1&fetch_child=0&status=0



  • 參數說明






















參數 必須 說明
access_token 是 調用接口憑證
department_id 是 獲取的部門id
fetch_child 否 1/0：是否遞歸獲取子部門下面的成員
status 否 0獲取全部員工，1獲取已關注成員列表，2獲取禁用成員列表，4獲取未關注成員列表。status可疊加


  • 權限說明

管理員須擁有’獲取部門成員’的接口權限，以及指定部門的查看權限。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "userlist": [ 
    5.            { 
    6.                   "userid": "zhangsan", 
    7.                   "name": "李四" 
    8.            } 
    9.      ] 
    10. } 




















參數 說明
errcode 返回碼
errmsg 對返回碼的文本描述內容
userlist 成員列表
userid 員工UserID
name 成員名稱


三、管理標簽


1、創建標簽



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN


注：標簽鎖默認為未加鎖狀態


請求包結構體為:

  1. { 
  2.    "tagname": "UI" 
  3. } 


  • 參數說明














參數 必須 說明
access_token 是 調用接口憑證
tagname 是 標簽名稱。長度為1~64個字符，標簽不可與其他同組的標簽重名，也不可與全局標簽重名


  • 權限說明

無限定。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "created" 
    4.    "tagid": "1" 
    5. } 

2、更新標簽名字



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/update?access_token=ACCESS_TOKEN


請求包示例如下:

  1. { 
  2.    "tagid": "1", 
  3.    "tagname": "UI design" 
  4. } 


  • 參數說明


















參數 必須 說明
access_token 是 調用接口憑證
tagid 是 標簽ID
tagname 是 標簽名稱。最長64個字符


  • 權限說明

管理員必須是指定標簽的創建者。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "updated" 
    4. } 

3、刪除標簽



  • 請求說明

Https請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/tag/delete?access_token=ACCESS_TOKEN&tagid=1



  • 參數說明














參數 必須 說明
access_token 是 調用接口憑證
tagid 是 標簽ID


  • 權限說明

管理員必須是指定標簽的創建者，并且標簽的成員列表為空。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "deleted" 
    4. } 

4、獲取標簽成員



  • 請求說明

Https請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/tag/get?access_token=ACCESS_TOKEN&tagid=1



  • 參數說明














參數 必須 說明
access_token 是 調用接口憑證
tagid 是 標簽ID


  • 權限說明

管理員須擁有“獲取標簽成員”的接口權限，標簽須對管理員可見；返回列表僅包含管理員管轄范圍的成員。



  • 返回結果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "userlist": [ 
    5.          { 
    6.              "userid": "zhangsan", 
    7.              "name": "李四" 
    8.          } 
    9.      ] 
    10. } 

















參數 說明
errcode 錯誤碼
errmsg 錯誤消息
userlist 成員列表
userid 員工UserID

5、增加標簽成員



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/addtagusers?access_token=ACCESS_TOKEN


請求包示例如下:

  1. { 
  2.    "tagid": "1", 
  3.    "userlist":[ "user1","user2"] 
  4. } 


  • 參數說明


















參數 必須 說明
access_token 是 調用接口憑證
tagid 是 標簽ID
userlist 是 企業員工ID列表


  • 權限說明

標簽對管理員可見且未加鎖，成員屬于管理員管轄范圍。



  • 返回結果

a)正確時返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "ok" 
  4. } 

b)若部分userid非法，則返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "invalid userlist failed" 
  4.    "invalidlist"："usr1|usr2|usr" 
  5. } 

c)當包含userid全部非法時返回

  1. { 
  2.    "errcode": 40070, 
  3.    "errmsg": "all list invalid " 
  4. } 














參數 說明
errcode 錯誤碼
errmsg 錯誤消息
invalidlist 不在權限內的員工ID列表，以“|”分隔

6、刪除標簽成員



  • 請求說明

Https請求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/deltagusers?access_token=ACCESS_TOKEN


請求包如下

  1. { 
  2.    "tagid": "1", 
  3.    "userlist":[ "user1","user2"] 
  4. } 


  • 參數說明


















參數 必須 說明
access_token 是 調用接口憑證
tagid 是 標簽ID
userlist 是 企業員工ID列表


  • 權限說明

標簽對管理員可見且未加鎖，成員屬于管理員管轄范圍。



  • 返回結果

a)正確時返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "deleted" 
  4. } 

b)若部分userid非法，則返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "invalid userlist failed" 
  4.    "invalidlist"："usr1|usr2|usr" 
  5. } 

c)當包含的userid全部非法時返回

  1. { 
  2.    "errcode": 40031, 
  3.    "errmsg": "all list invalid" 
  4. } 














參數 說明
errcode 錯誤碼
errmsg 錯誤消息
invalidlist 不在權限內的或者非法的員工ID列表，以“|”分隔

該文章在 2014/12/2 0:47:33 編輯過
關鍵字查詢
相關文章
正在查詢...
點晴ERP是一款針對中小制造業的專業生產管理軟件系統,系統成熟度和易用性得到了國內大量中小企業的青睞。
點晴PMS碼頭管理系統主要針對港口碼頭集裝箱與散貨日常運作、調度、堆場、車隊、財務費用、相關報表等業務管理，結合碼頭的業務特點，圍繞調度、堆場作業而開發的。集技術的先進性、管理的有效性于一體，是物流碼頭及其他港口類企業的高效ERP管理信息系統。
點晴WMS倉儲管理系統提供了貨物產品管理,銷售管理,采購管理,倉儲管理,倉庫管理,保質期管理,貨位管理,庫位管理,生產管理,WMS管理系統,標簽打印,條形碼,二維碼管理,批號管理軟件。
點晴免費OA是一款軟件和通用服務都免費，不限功能、不限時間、不限用戶的免費OA協同辦公管理系統。
Copyright 2010-2025 ClickSun All Rights Reserved