狠狠色丁香婷婷综合尤物/久久精品综合一区二区三区/中国有色金属学报/国产日韩欧美在线观看 - 国产一区二区三区四区五区tv

LOGO OA教程 ERP教程 模切知識交流 PMS教程 CRM教程 開發(fā)文檔 其他文檔  
 
網(wǎng)站管理員

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




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

企業(yè)號通訊錄具備完全開放的接口，你的應(yīng)用可以調(diào)用這些接口管理部門、成員和標(biāo)簽。


你的應(yīng)用也可以使用部門、成員、標(biāo)簽發(fā)消息，或更改應(yīng)用的可見范圍。


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


一、管理部門


1、創(chuàng)建部門



  • 請求說明

Https請求方式: POST


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


請求包結(jié)構(gòu)體為:

  1. { 
  2.    "name": "郵箱產(chǎn)品組", 
  3.    "parentid": "1" 
  4. } 


  • 參數(shù)說明


















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


  • 權(quán)限說明

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



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














參數(shù) 說明
errcode 返回碼
errmsg 對返回碼的文本描述內(nèi)容
id 創(chuàng)建的部門id。

2、更新部門



  • 請求說明

Https請求方式: POST


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


請求包結(jié)構(gòu)體為（如果非必須的字段未指定，則不更新該字段之前的設(shè)置值）:

  1. { 
  2.    "id": 2, 
  3.    "name": "郵箱產(chǎn)品部" 
  4. } 


  • 參數(shù)說明


















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


  • 權(quán)限說明

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



  • 返回結(jié)果 
    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



  • 參數(shù)說明














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


  • 權(quán)限說明

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



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

4、獲取部門列表



  • 請求說明

Https請求方式: GET


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



  • 參數(shù)說明










參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證


  • 權(quán)限說明

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



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























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



二、管理成員


1、創(chuàng)建成員



  • 請求說明

Https請求方式: POST


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


請求包結(jié)構(gòu)體為:

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


  • 參數(shù)說明














































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


  • 權(quán)限說明

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



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

2、更新成員



  • 請求說明

Https請求方式: POST


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


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

  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. } 


  • 參數(shù)說明


















































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


  • 權(quán)限說明

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



  • 返回結(jié)果 
    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



  • 參數(shù)說明














參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
userid 是 員工UserID。對應(yīng)管理端的帳號


  • 權(quán)限說明

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



  • 返回結(jié)果 
    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



  • 參數(shù)說明














參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
userid 是 員工UserID


  • 返回結(jié)果 
    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. } 












































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


  • 權(quán)限說明

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


5、獲取部門成員



  • 請求說明

Https請求方式: GET


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



  • 參數(shù)說明






















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


  • 權(quán)限說明

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



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




















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


三、管理標(biāo)簽


1、創(chuàng)建標(biāo)簽



  • 請求說明

Https請求方式: POST


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


注：標(biāo)簽鎖默認(rèn)為未加鎖狀態(tài)


請求包結(jié)構(gòu)體為:

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


  • 參數(shù)說明














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


  • 權(quán)限說明

無限定。



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

2、更新標(biāo)簽名字



  • 請求說明

Https請求方式: POST


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


請求包示例如下:

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


  • 參數(shù)說明


















參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
tagid 是 標(biāo)簽ID
tagname 是 標(biāo)簽名稱。最長64個字符


  • 權(quán)限說明

管理員必須是指定標(biāo)簽的創(chuàng)建者。



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

3、刪除標(biāo)簽



  • 請求說明

Https請求方式: GET


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



  • 參數(shù)說明














參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
tagid 是 標(biāo)簽ID


  • 權(quán)限說明

管理員必須是指定標(biāo)簽的創(chuàng)建者，并且標(biāo)簽的成員列表為空。



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

4、獲取標(biāo)簽成員



  • 請求說明

Https請求方式: GET


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



  • 參數(shù)說明














參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
tagid 是 標(biāo)簽ID


  • 權(quán)限說明

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



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

















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

5、增加標(biāo)簽成員



  • 請求說明

Https請求方式: POST


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


請求包示例如下:

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


  • 參數(shù)說明


















參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
tagid 是 標(biāo)簽ID
userlist 是 企業(yè)員工ID列表


  • 權(quán)限說明

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



  • 返回結(jié)果

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)當(dāng)包含userid全部非法時返回

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














參數(shù) 說明
errcode 錯誤碼
errmsg 錯誤消息
invalidlist 不在權(quán)限內(nèi)的員工ID列表，以“|”分隔

6、刪除標(biāo)簽成員



  • 請求說明

Https請求方式: POST


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


請求包如下

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


  • 參數(shù)說明


















參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
tagid 是 標(biāo)簽ID
userlist 是 企業(yè)員工ID列表


  • 權(quán)限說明

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



  • 返回結(jié)果

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)當(dāng)包含的userid全部非法時返回

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














參數(shù) 說明
errcode 錯誤碼
errmsg 錯誤消息
invalidlist 不在權(quán)限內(nèi)的或者非法的員工ID列表，以“|”分隔

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