釘釘應(yīng)用開(kāi)發(fā)者速成手冊(cè)

什么是釘釘開(kāi)放平臺(tái)？4注冊(cè)釘釘開(kāi)發(fā)者11釘釘開(kāi)放平臺(tái)名詞解釋16如何調(diào)用釘釘API22服務(wù)端API23使用APIExplorer31使用JSAPIExplorer39釘釘應(yīng)用開(kāi)發(fā)入門(mén)44小程序45H5微應(yīng)用56API實(shí)戰(zhàn)64同步打卡數(shù)據(jù)65搭建審批工作流76釘釘能力概覽90什么是釘釘開(kāi)放平臺(tái)？什么是釘釘開(kāi)放平臺(tái)？整個(gè)釘釘開(kāi)放平臺(tái)可劃分為以下三個(gè)部分：l門(mén)戶(hù)當(dāng)前共有三個(gè)主要的門(mén)戶(hù)，分別如下：n開(kāi)發(fā)者后臺(tái)：用于開(kāi)發(fā)者登陸，創(chuàng)建應(yīng)用，管理應(yīng)用等。n開(kāi)發(fā)文檔：可以看到各個(gè)服務(wù)端API、前端API的文檔介紹，和一些快速入門(mén)課程。n開(kāi)放平臺(tái)官網(wǎng)：有整個(gè)開(kāi)放平臺(tái)的一些三方應(yīng)用，案例介紹等。l動(dòng)態(tài)通知開(kāi)發(fā)平臺(tái)提供的動(dòng)態(tài)通知方式包含如下：n“開(kāi)發(fā)者助手”服務(wù)窗：提供釘釘開(kāi)放平臺(tái)的系統(tǒng)通知、開(kāi)放能力更新、精選文章、活動(dòng)邀約等。n公告通知：可以通過(guò)公告發(fā)布公司規(guī)章制度、放假信息等。n文檔更新日志：文檔更新記錄，開(kāi)發(fā)者可快速的了解文檔更新情況。n開(kāi)發(fā)者釘釘圈子：可快速了解到關(guān)于釘釘功能的熱門(mén)信息。n開(kāi)發(fā)者釘釘群：可通過(guò)群的形式，發(fā)布和獲取企業(yè)動(dòng)態(tài)消息。l技術(shù)支持開(kāi)放平臺(tái)提供的技術(shù)支持方式分為以下方面：n工單系統(tǒng)：開(kāi)發(fā)者后臺(tái)的工單系統(tǒng)，可以在上面提交工單，客服會(huì)及時(shí)回復(fù)。n答疑機(jī)器人：使用群內(nèi)答疑機(jī)器人，可以快速的解答咨詢(xún)問(wèn)題。n最佳實(shí)踐和FAQ：開(kāi)發(fā)文檔上有最佳實(shí)踐和FAQ等，可以快速幫助開(kāi)發(fā)者查到問(wèn)題的解決方案。n技術(shù)沙龍和線(xiàn)上直播：定期提供技術(shù)沙龍或線(xiàn)上直播給大家。釘釘開(kāi)放平臺(tái)支持以下能力：什什l賬號(hào)授權(quán)（免登）開(kāi)發(fā)者可以基于釘釘開(kāi)放平臺(tái)提供的授權(quán)能力將釘釘端外的應(yīng)用接入到釘釘，支持掃碼登錄和使用釘釘賬號(hào)登錄。l分享SDK開(kāi)發(fā)者可以使用釘釘?shù)姆窒鞸DK接入釘釘分享功能。用戶(hù)在分享應(yīng)用時(shí)可以選擇分享到釘釘。l機(jī)器人群機(jī)器人是釘釘群的高級(jí)擴(kuò)展功能。群機(jī)器人可以將第三方服務(wù)的信息聚合到群聊中，實(shí)現(xiàn)自動(dòng)化的信息同步。目前，大部分機(jī)器人在被添加后，還需要進(jìn)行Webhook配置，才可正常使用。另外，群機(jī)器人支持Webhook協(xié)議的自定義接入，例如防疫精靈機(jī)器人可以為企業(yè)提供新型冠狀病毒疫情實(shí)況推送、預(yù)防措施自動(dòng)問(wèn)答服務(wù)，幫助員工在新冠疫情期間獲取最新疫情、最新權(quán)威預(yù)防措施。群成員可以直接@防疫精靈機(jī)器人進(jìn)行疫情實(shí)況和預(yù)防措施問(wèn)答，機(jī)器人也會(huì)定時(shí)推送最新疫情給群成員。釘釘群機(jī)器人致力于把釘釘群聊的消息輸出到外部，以及接收外部的消息輸入。l小程序小程序是一種全新的開(kāi)發(fā)模式，讓移動(dòng)開(kāi)發(fā)者通過(guò)簡(jiǎn)潔的前端語(yǔ)法寫(xiě)出Native級(jí)別的性能體驗(yàn)，并支持iOS、Android等多端部署。lH5微應(yīng)用微應(yīng)用是指用H5方式開(kāi)發(fā)的應(yīng)用。小程序和H5微應(yīng)用對(duì)比如下：對(duì)比項(xiàng)小程序H5微應(yīng)用加載性能首次使用略慢，后續(xù)加載快受很多因素影響，優(yōu)化不夠好，容易慢使用性能順滑，接近Native容易卡頓頁(yè)面跳轉(zhuǎn)/切換和Native的效果一樣無(wú)法達(dá)到Native的效果開(kāi)發(fā)環(huán)境搭建提供IDE，快速創(chuàng)建項(xiàng)目未提供IDE，需開(kāi)發(fā)者搭建，成本高調(diào)試提供IDE，可以在電腦上調(diào)試大部分功能在電腦上只能調(diào)UI，涉及到釘釘?shù)腏SAPI，必須真機(jī)調(diào)試對(duì)比項(xiàng)小程序H5微應(yīng)用使用開(kāi)源UI組件目前不支持支持使用NPM包支持支持模塊化組織代碼支持小程序特有的模塊化使用Vue、React等框架可以獲得模塊化支持灰度發(fā)布釘釘提供需要開(kāi)發(fā)者實(shí)現(xiàn)CDN小程序包默認(rèn)在CDN需要開(kāi)發(fā)者自己購(gòu)買(mǎi)相關(guān)服務(wù)開(kāi)發(fā)個(gè)人應(yīng)用支持不支持應(yīng)用離線(xiàn)化支持不支持釘釘為企業(yè)和組織提供了很多基礎(chǔ)辦公應(yīng)用例如審批、日志、視頻會(huì)議等。企業(yè)可基于釘釘開(kāi)放平臺(tái)的能力，根據(jù)實(shí)際需要定制開(kāi)發(fā)企業(yè)應(yīng)用。應(yīng)用類(lèi)型開(kāi)發(fā)者使用人員支持的能力是否支持上架到釘釘應(yīng)用廣場(chǎng)第三方企業(yè)應(yīng)用應(yīng)用服務(wù)商的開(kāi)發(fā)者購(gòu)買(mǎi)開(kāi)通該三方應(yīng)用的企業(yè)內(nèi)部人員小程序H5微應(yīng)用上架流程請(qǐng)參考上架流程。企業(yè)內(nèi)部應(yīng)用企業(yè)內(nèi)部開(kāi)發(fā)者或委托的定制服務(wù)商開(kāi)發(fā)者安裝了該應(yīng)用的企業(yè)內(nèi)部人員小程序H5微應(yīng)用機(jī)器人否第三方個(gè)人應(yīng)用應(yīng)用服務(wù)商的開(kāi)發(fā)者釘釘?shù)膫€(gè)人用戶(hù)小程序是，需要滿(mǎn)足上架要求請(qǐng)參考第三方個(gè)人應(yīng)用發(fā)布規(guī)范。應(yīng)用類(lèi)型開(kāi)發(fā)者使用人員支持的能力是否支持上架到釘釘應(yīng)用廣場(chǎng)移動(dòng)接入應(yīng)用應(yīng)用服務(wù)商的開(kāi)發(fā)者企業(yè)內(nèi)部開(kāi)發(fā)者要接入的應(yīng)用的用戶(hù)登錄（釘釘掃碼和使用釘釘賬號(hào)登錄）分享（將應(yīng)用分享到釘釘）開(kāi)放平臺(tái)的接入方式，如下圖所示：企業(yè)內(nèi)部應(yīng)用是企業(yè)基于釘釘?shù)拈_(kāi)放能力，開(kāi)發(fā)個(gè)性化的辦公應(yīng)用供企業(yè)內(nèi)部使用，例如將企業(yè)內(nèi)部的HR、CRM、業(yè)務(wù)管理等系統(tǒng)接入釘釘。企業(yè)內(nèi)部應(yīng)用發(fā)布后，企業(yè)內(nèi)部用戶(hù)可以直接從釘釘工作臺(tái)中打開(kāi)、使用該應(yīng)用。企業(yè)內(nèi)部應(yīng)用可以由企業(yè)內(nèi)部開(kāi)發(fā)人員自主開(kāi)發(fā)，也可以委托給定制服務(wù)商進(jìn)行應(yīng)用開(kāi)發(fā)。應(yīng)用類(lèi)型開(kāi)發(fā)者使用人員支持的能力是否支持上架到釘釘應(yīng)用廣場(chǎng)企業(yè)內(nèi)部應(yīng)用企業(yè)內(nèi)部開(kāi)發(fā)者或委托的定制服務(wù)商開(kāi)發(fā)者安裝了該應(yīng)用的企業(yè)內(nèi)部人員小程序H5微應(yīng)用機(jī)器人否第三方企業(yè)應(yīng)用第三方企業(yè)應(yīng)用是由應(yīng)用服務(wù)商開(kāi)發(fā)的第三方企業(yè)應(yīng)用，可以上架到釘釘應(yīng)用廣場(chǎng)售賣(mài)給釘釘?shù)钠髽I(yè)組織使用。企業(yè)管理員可以在釘釘?shù)膽?yīng)用廣場(chǎng)找到需要的第三方企業(yè)應(yīng)用，開(kāi)通后讓企業(yè)內(nèi)的員工使用。如下表所示，第三方企業(yè)應(yīng)用的開(kāi)發(fā)人員必須是應(yīng)用服務(wù)商的開(kāi)發(fā)者。應(yīng)用類(lèi)型開(kāi)發(fā)者使用人員支持的能力是否能上架到廣場(chǎng)第三方企業(yè)應(yīng)用應(yīng)用服務(wù)商的開(kāi)發(fā)者購(gòu)買(mǎi)開(kāi)通該三方應(yīng)用的企業(yè)內(nèi)部人員小程序H5微應(yīng)用是，需要滿(mǎn)足上架要求，上架流程請(qǐng)參考上架流程。第三方個(gè)人應(yīng)用第三方個(gè)人應(yīng)用與企業(yè)內(nèi)部應(yīng)用、第三方企業(yè)應(yīng)用不同，個(gè)人應(yīng)用主要是提供給釘釘上的個(gè)人用戶(hù)來(lái)使用，不需要企業(yè)進(jìn)行授權(quán)開(kāi)通，也無(wú)需感知企業(yè)信息，只需要個(gè)人進(jìn)行授權(quán)即可使用。應(yīng)用類(lèi)型開(kāi)發(fā)者使用人員支持的能力是否支持上架到釘釘應(yīng)用廣場(chǎng)第三方個(gè)人應(yīng)用應(yīng)用服務(wù)商的開(kāi)發(fā)者釘釘?shù)膫€(gè)人用戶(hù)小程序是，需要滿(mǎn)足上架要求，上架流程請(qǐng)參考產(chǎn)品上架流程。注冊(cè)釘釘開(kāi)發(fā)者注冊(cè)釘釘開(kāi)發(fā)者簡(jiǎn)介：在開(kāi)始使用開(kāi)放平臺(tái)提供的能力進(jìn)行應(yīng)用開(kāi)發(fā)前簡(jiǎn)介：在開(kāi)始使用開(kāi)放平臺(tái)提供的能力進(jìn)行應(yīng)用開(kāi)發(fā)前，需要先完成釘釘開(kāi)發(fā)者注冊(cè)。1.實(shí)名認(rèn)證參考以下步驟，完成釘釘實(shí)名認(rèn)證：1.1打開(kāi)釘釘手機(jī)客戶(hù)端，單擊個(gè)人頭像，然后選擇設(shè)置。1.2在設(shè)置頁(yè)面，選擇我的信息。1.3在個(gè)人信息頁(yè)面，單擊個(gè)人實(shí)人認(rèn)證。個(gè)人實(shí)人認(rèn)證有以下兩種方式：l身份證認(rèn)證該方式需要本人完成且需要填寫(xiě)本人身份證信息，請(qǐng)?zhí)崆皽?zhǔn)備好身份證。l本人支付寶將自動(dòng)跳轉(zhuǎn)到第三方支付寶界面進(jìn)行個(gè)人認(rèn)證。2.申請(qǐng)權(quán)限參考以下步驟，將開(kāi)發(fā)者添加為子管理員并賦予相關(guān)的開(kāi)發(fā)者權(quán)限：2.1組織主管理員登陸釘釘管理后臺(tái)。2.2單擊設(shè)置，選擇右側(cè)設(shè)置子管理員，然后單擊添加。2.3在基礎(chǔ)權(quán)限中找到開(kāi)發(fā)者權(quán)限和工作臺(tái)管理，選擇全部。釘釘開(kāi)放平臺(tái)名詞解釋釘釘開(kāi)放平臺(tái)名詞解釋簡(jiǎn)介：在開(kāi)始開(kāi)發(fā)前簡(jiǎn)介：在開(kāi)始開(kāi)發(fā)前，建議您先了解開(kāi)放平臺(tái)的名詞解釋。開(kāi)發(fā)者后臺(tái)是管理應(yīng)用開(kāi)發(fā)的服務(wù)平臺(tái)。開(kāi)發(fā)者可以配置應(yīng)用信息，查看應(yīng)用運(yùn)行情況等。企業(yè)管理后臺(tái)是管理員管理企業(yè)賬號(hào)和工作臺(tái)應(yīng)用配置的服務(wù)平臺(tái)。管理員可以添加子管理員，一鍵導(dǎo)入通訊錄，進(jìn)行審批流配置等。.18I釘釘合作伙伴平臺(tái)，用于服務(wù)商管理的平臺(tái)，提供技術(shù)、部署、服務(wù)全鏈路支持。目前包含應(yīng)用服務(wù)商、定制服務(wù)商、部署服務(wù)商和培訓(xùn)服務(wù)商。CorpId是企業(yè)在釘釘中的標(biāo)識(shí)，每個(gè)企業(yè)擁有唯一的CorpId。登錄開(kāi)發(fā)者后臺(tái)，在首頁(yè)查看企業(yè)的CorpId。企業(yè)內(nèi)每個(gè)員工都有唯一的UserId，創(chuàng)建后不可修改。登錄企業(yè)管理后臺(tái)，在通訊錄頁(yè)面單擊員工姓名可查看員工的UserId。用戶(hù)在當(dāng)前釘釘開(kāi)放平臺(tái)賬號(hào)范圍內(nèi)的唯一標(biāo)識(shí)，同一個(gè)釘釘開(kāi)放平臺(tái)賬號(hào)可以包含多個(gè)開(kāi)放應(yīng)用，同時(shí)也包含ISV的套件應(yīng)用及企業(yè)應(yīng)用。在開(kāi)發(fā)者后臺(tái)創(chuàng)建企業(yè)內(nèi)部應(yīng)用后，系統(tǒng)會(huì)自動(dòng)生成一對(duì)AppKey和AppSecret。登錄開(kāi)發(fā)者后臺(tái)，在應(yīng)用開(kāi)發(fā)頁(yè)面，單擊已創(chuàng)建的應(yīng)用，然后單擊憑證與基礎(chǔ)信息查看AppKey和AppSecret。lAppKey：應(yīng)用的唯一身份標(biāo)識(shí)。lAppSecret：對(duì)應(yīng)的調(diào)用密鑰。說(shuō)明：如果企業(yè)內(nèi)部應(yīng)用授權(quán)給定制服務(wù)商開(kāi)發(fā)，定制服務(wù)商需要根據(jù)CustomKey和CustomSecret獲取授權(quán)。八、SuiteKey/SuiteSecret在開(kāi)發(fā)者后臺(tái)創(chuàng)建第三方應(yīng)用后，系統(tǒng)會(huì)自動(dòng)生成一對(duì)SuiteKey和SuiteSecret。登錄開(kāi)發(fā)者后臺(tái)，在應(yīng)用開(kāi)發(fā)頁(yè)面，單擊已創(chuàng)建的應(yīng)用，然后單擊憑證與基礎(chǔ)信息查看SuiteKey和SuiteSecret。lSuiteKey：應(yīng)用的唯一身份標(biāo)識(shí)。lSuiteSecret:對(duì)應(yīng)的調(diào)用密鑰。每一個(gè)個(gè)人應(yīng)用都會(huì)分配一個(gè)AppId和AppSecret，該AppId和AppSecret是個(gè)人應(yīng)用開(kāi)發(fā)過(guò)程中的唯一性標(biāo)識(shí)，用來(lái)獲取登錄用戶(hù)授權(quán)的access__token。十、access_tokenaccess__token是企業(yè)后臺(tái)通過(guò)釘釘接口獲取信息的重要憑據(jù)。在調(diào)用釘釘接口時(shí)必須攜帶access__token用于驗(yàn)證接口的訪(fǎng)問(wèn)權(quán)限。AgentId是應(yīng)用的唯一標(biāo)識(shí)。在開(kāi)發(fā)者后臺(tái)創(chuàng)建應(yīng)用后，系統(tǒng)會(huì)自動(dòng)生成一個(gè)AgentId。登錄開(kāi)發(fā)者后臺(tái)，在應(yīng)用開(kāi)發(fā)頁(yè)面，單擊已創(chuàng)建的應(yīng)用，然后單擊憑證與基礎(chǔ)信息查看AgentId。如何調(diào)用釘釘API23>服務(wù)端API服務(wù)端API簡(jiǎn)介：為了滿(mǎn)足客戶(hù)需求簡(jiǎn)介：為了滿(mǎn)足客戶(hù)需求，釘釘目前主要提供了身份驗(yàn)證、通訊錄管理、消息通知、智能辦公四大類(lèi)的服務(wù)端API接口給開(kāi)發(fā)者使用。身份驗(yàn)證免登是指用戶(hù)進(jìn)入應(yīng)用后，無(wú)需輸入釘釘用戶(hù)名和密碼，應(yīng)用程序可自動(dòng)獲取當(dāng)前用戶(hù)身份，進(jìn)而登錄系統(tǒng)的流程。身份驗(yàn)證的服務(wù)端API主要分為五部分，如下圖所示：l釘釘應(yīng)用內(nèi)免登實(shí)現(xiàn)企業(yè)內(nèi)部或第三方企業(yè)應(yīng)用免登，即企業(yè)員工在釘釘內(nèi)使用企業(yè)內(nèi)部應(yīng)用或第三方企業(yè)應(yīng)用時(shí)無(wú)需輸入賬號(hào)和密碼?？赏ㄟ^(guò)以下步驟實(shí)現(xiàn)：n獲取JSAPI免登授權(quán)碼。n獲取用戶(hù)userId。n獲取用戶(hù)詳情。l管理后臺(tái)免登應(yīng)用管理后臺(tái)免登指管理員在釘釘管理后臺(tái)對(duì)應(yīng)用進(jìn)行設(shè)置和管理時(shí)，無(wú)需輸入該應(yīng)用的賬號(hào)和密碼，可直接登錄應(yīng)用的管理后臺(tái)?？赏ㄟ^(guò)以下步驟實(shí)現(xiàn)：n獲取免登授權(quán)碼。n獲取管理員身份信息。l掃碼登錄實(shí)現(xiàn)掃碼登錄第三方網(wǎng)站。掃碼登錄指釘釘客戶(hù)端掃碼并確認(rèn)登錄web系統(tǒng)，在系統(tǒng)內(nèi)獲取正在訪(fǎng)問(wèn)用戶(hù)的釘釘身份，無(wú)需輸入賬號(hào)密碼的開(kāi)發(fā)流程。提供了以下兩種方式：n直接使用釘釘提供的掃碼登錄頁(yè)面。n開(kāi)發(fā)者可以將釘釘?shù)牡卿浂S碼內(nèi)嵌到自己的網(wǎng)站中，讓用戶(hù)進(jìn)行掃碼登錄。l釘釘內(nèi)免登n實(shí)現(xiàn)釘釘內(nèi)免登第三方網(wǎng)站。釘釘內(nèi)免登第三方網(wǎng)站指用戶(hù)在釘釘客戶(hù)端內(nèi)點(diǎn)擊H5網(wǎng)站鏈接時(shí)，無(wú)需輸入賬號(hào)密碼系統(tǒng)自動(dòng)獲取正在訪(fǎng)問(wèn)用戶(hù)釘釘身份。l密碼登錄n實(shí)現(xiàn)使用釘釘賬號(hào)登錄第三方網(wǎng)站。通過(guò)手動(dòng)輸入釘釘?shù)馁~號(hào)密碼，登錄第三方獨(dú)立的web系統(tǒng)，并獲得正在訪(fǎng)問(wèn)用戶(hù)的釘釘身份。通訊錄是開(kāi)發(fā)者接入釘釘時(shí)最常用到的一批接口，主要包含四大類(lèi)接口，如下圖所示：說(shuō)明：在調(diào)用通訊錄相關(guān)接口前，請(qǐng)先添加對(duì)應(yīng)的通訊錄權(quán)限。開(kāi)發(fā)者可以調(diào)用通訊錄接口，將通訊錄數(shù)據(jù)寫(xiě)到釘釘中，用于獲取釘釘通訊錄。如果企業(yè)想實(shí)時(shí)接收通訊錄變更，可以注冊(cè)釘釘?shù)耐ㄓ嶄浕卣{(diào)，實(shí)時(shí)接收通訊錄的回調(diào)內(nèi)容。25>服務(wù)端APIl用戶(hù)管理包括增刪改用戶(hù)的接口，還可以獲取部門(mén)下的用戶(hù)，獲取用戶(hù)詳情，獲取管理員列表，跟進(jìn)unionId獲取userId，獲取企業(yè)人數(shù)等接口。l部門(mén)管理包括增刪改部門(mén)，獲取部門(mén)ID列表，獲取部門(mén)詳情，獲取部門(mén)上級(jí)部門(mén)，獲取用戶(hù)上級(jí)部門(mén)等接口。l角色管理角色分為角色和角色組，所以我們有增加刪除修改角色，增加刪除角色組合員工，獲取角色組，獲取角色列表和詳情，獲取角色下的員工列表等接口。l外部聯(lián)系人管理包括增刪改外部聯(lián)系人，獲取外部聯(lián)系人列表，詳情，和標(biāo)簽列表等接口。消息通知主要分為三部分，如下圖所示：l工作通知消息是以企業(yè)工作通知會(huì)話(huà)中某個(gè)微應(yīng)用的名義推送到員工的通知消息，例如審批通知，任務(wù)通知等。說(shuō)明：n該接口是異步接口，接口返回成功并不表示用戶(hù)一定會(huì)收到消息，需要通過(guò)“查詢(xún)工作通知消息的發(fā)送結(jié)果”接口查詢(xún)是否發(fā)送成功。n工作通知消息也有一些限流規(guī)則，具體規(guī)則可參考調(diào)用頻率限制。l群會(huì)話(huà)消息n是指可以調(diào)用接口，以系統(tǒng)名義向群里推送群聊消息。與之配合的是對(duì)應(yīng)的創(chuàng)建群，更新群，獲取群人員列表等服務(wù)端API接口。l普通會(huì)話(huà)消息l是指可以調(diào)用接口，以系統(tǒng)名義向群里推送群聊消息。與之配合的是對(duì)應(yīng)的創(chuàng)建群，更新群，獲取群人員列表等服務(wù)端API接口。智能辦公包含以下七個(gè)部分，如下圖所示：27>服務(wù)端APIl智能工作流包括發(fā)起審批實(shí)例，創(chuàng)建更新模板，創(chuàng)建更新待辦，獲取審批詳情，審批回調(diào)，審批跳轉(zhuǎn)，待辦任務(wù)等接口。l考勤可以獲取考勤數(shù)據(jù)，獲取請(qǐng)假數(shù)據(jù)，獲取考勤組信息，獲取排班信息等。可以獲取日志數(shù)據(jù)，日志的已讀、未讀、評(píng)論、點(diǎn)贊等信息，獲取日志模板。l簽到可以獲取用戶(hù)的簽到記錄l智能填表可以獲取企業(yè)智能填表的一些數(shù)據(jù)，還可以獲取填表的一些模板。l智能人事可查詢(xún)待入職員工，查詢(xún)?cè)诼殕T工，查詢(xún)離職員工，還有獲取花名冊(cè)信息，添加待入職員工等接口。l公告可以獲取用戶(hù)公告數(shù)據(jù)，包括公告的時(shí)間等。要調(diào)用API需要以下三個(gè)基礎(chǔ)條件：l釘釘應(yīng)用釘釘應(yīng)用作為您調(diào)用API時(shí)的身份，有AppKey和AppSecret用于驗(yàn)證您的身份?？梢栽卺斸旈_(kāi)放平臺(tái)的應(yīng)用開(kāi)發(fā)頁(yè)面創(chuàng)建應(yīng)用，創(chuàng)建應(yīng)用成功后，系統(tǒng)會(huì)自動(dòng)生成AppKey和AppSecret。lAPI在調(diào)用相關(guān)接口時(shí)，需要明確您即將需要調(diào)用的API相關(guān)參數(shù)定義。l相關(guān)權(quán)限在調(diào)用相關(guān)接口前，您可能需要先申請(qǐng)對(duì)應(yīng)的接口權(quán)限。您可以登陸釘釘開(kāi)放平臺(tái)，選擇您創(chuàng)建的應(yīng)用，選擇權(quán)限管理，添加相應(yīng)接口權(quán)限?？赏ㄟ^(guò)以下步驟，完成服務(wù)端API接口的調(diào)用：1.獲取access__token。調(diào)用服務(wù)端API，首先要獲取access__token。調(diào)用access__token的請(qǐng)求方式為GET（HTTPS請(qǐng)求地址如下圖所示，要輸入兩個(gè)參數(shù)appkey和appsecret。說(shuō)明：l正常情況下access__token的有效期是7200秒，有效期內(nèi)重復(fù)獲取會(huì)返回相同結(jié)果，并且自動(dòng)續(xù)期。lPOST請(qǐng)求必須在HTTPHeader中設(shè)置對(duì)應(yīng)的Content-Type:application/json。釘釘官方提供了統(tǒng)一的Java、PHP、.NET、Python對(duì)應(yīng)的SDK，可參考服務(wù)端SDK下載。29>服務(wù)端API2.調(diào)用相關(guān)API接口?？赏ㄟ^(guò)以下方式調(diào)用服務(wù)端API接口：說(shuō)明為了防止企業(yè)和ISV的應(yīng)用程序錯(cuò)誤從而引發(fā)釘釘服務(wù)器負(fù)載異常，默認(rèn)情況下，每個(gè)服務(wù)端調(diào)用接口都會(huì)有一定的頻率限制。當(dāng)超過(guò)此限制時(shí)，調(diào)用接口會(huì)收到對(duì)應(yīng)的錯(cuò)誤碼。限流規(guī)則可參考調(diào)用頻率限制。方式一：使用API文檔中提供的SDK示例代碼進(jìn)行調(diào)用。DingTalkClientDingTalkClientclient=newDefaultDingTalkCOapiGettokenRequestrequest=newOapiGettokenRequest();request.setAppkey("appkey");request.setAppsecret("appsecret");request.setHttpMethod("GET");OapiGettokenResponseresponse=client.execute(request);System.out.println(response.getBody());方式二：自行編輯HTTP(s)請(qǐng)求來(lái)調(diào)用API。請(qǐng)求方式:請(qǐng)求方式:GET/POST(HTTPS)請(qǐng)求地址:/gettoken?appkey=appkey&appsecret=appsecret:..:...SDK請(qǐng)求示例:l請(qǐng)求方式：接口有HttpGet/HttpPost兩種方式。所有的請(qǐng)求都為HTTPS協(xié)議。l請(qǐng)求地址：都以開(kāi)頭。l參數(shù)說(shuō)明：包括字段含義、取值范圍。比如HttpPost的請(qǐng)求包體就是requestbody的方式。lSDK請(qǐng)求示例：使用SDK時(shí)調(diào)用接口的Java代碼示例。l返回結(jié)果：釘釘所有接口的返回結(jié)果里都有errcode、errmsg。開(kāi)發(fā)者需根據(jù)errcode是否為0判斷是否調(diào)用成功。errcode為0表示調(diào)用成功，不為零表示失敗，會(huì)生成對(duì)應(yīng)的errmsg。開(kāi)發(fā)平臺(tái)文檔上還有全局錯(cuò)誤碼，針對(duì)每個(gè)echo都會(huì)有一個(gè)對(duì)應(yīng)解決方案的描述。31>使用APIExplorer使用APIExplorer簡(jiǎn)介：APIExplorer是釘釘開(kāi)放平臺(tái)提供的可視化服務(wù)端API調(diào)用工具，方便開(kāi)發(fā)者在線(xiàn)發(fā)起API調(diào)用。本文將以APIExplorer工具發(fā)起一個(gè)待辦事項(xiàng)為例，幫助您快速了解APIExplorer工具的使用。1.使用釘釘開(kāi)發(fā)者賬號(hào)登錄開(kāi)發(fā)者后臺(tái)，在企業(yè)內(nèi)部下，選擇小程序，然后單擊創(chuàng)建應(yīng)用。2.填寫(xiě)應(yīng)用名稱(chēng)、應(yīng)用描述，選擇應(yīng)用圖標(biāo)，最后單擊確定創(chuàng)建。使用APIExplorer<32應(yīng)用創(chuàng)建完成后，在憑證與基礎(chǔ)信息頁(yè)面，復(fù)制應(yīng)用的AgentId、AppKey和AppSecret備用。3.選擇開(kāi)發(fā)管理，單擊修改，完成以下配置：33>使用APIExplorerl服務(wù)器出口IP：輸入調(diào)用釘釘服務(wù)端API時(shí)使用的IP即企業(yè)服務(wù)器的公網(wǎng)IP，多個(gè)IP請(qǐng)以","隔開(kāi)，支持帶一個(gè)*號(hào)通配符的IP格式。說(shuō)明：服務(wù)器出口IP需要填寫(xiě)開(kāi)發(fā)者自己的公網(wǎng)出口IP，可通過(guò)工具進(jìn)行查看。lPC端首頁(yè)地址（可選輸入在PC端釘釘工作臺(tái)上打開(kāi)本應(yīng)用的地址。鏈接地址必須以http或https開(kāi)頭。說(shuō)明：如果未填寫(xiě)，在釘釘PC端工作臺(tái)點(diǎn)擊應(yīng)用圖標(biāo)時(shí)，會(huì)提示“電腦版暫不支持顯示，請(qǐng)用手機(jī)釘釘掃描下方二維碼查看”。只能在手機(jī)釘釘客戶(hù)端使用該應(yīng)用。l管理后臺(tái)地址（可選輸入組織管理員在釘釘管理后臺(tái)訪(fǎng)問(wèn)該應(yīng)用的地址。4.選擇權(quán)限管理，然后單擊添加接口權(quán)限，使用APIExplorer<345.選擇待辦事項(xiàng)的接口權(quán)限，最后單擊確認(rèn)。通過(guò)以下步驟，使用APIExplorer工具完成發(fā)起待辦：1.在開(kāi)發(fā)者后臺(tái)的首頁(yè)打開(kāi)APIExplorer。2.獲取企業(yè)憑證access__token。通過(guò)調(diào)用/gettoken接口獲取企業(yè)憑證access__token，獲取步驟如下：35>使用APIExplorerl選擇應(yīng)用類(lèi)型為企業(yè)內(nèi)部應(yīng)用。n企業(yè)內(nèi)部應(yīng)用：當(dāng)前API接口僅限于企業(yè)內(nèi)部調(diào)用。n第三方企業(yè)應(yīng)用：當(dāng)前API接口僅限于第三方企業(yè)調(diào)用。l依次選擇左側(cè)獲取憑證，然后選擇獲取企業(yè)憑證。l填寫(xiě)appkey和appsecret，然后單擊發(fā)起調(diào)用。nappkey：已創(chuàng)建應(yīng)用的AppKey。nappsecret：已創(chuàng)建應(yīng)用的AppSecret。說(shuō)明：APIExplorer右側(cè)會(huì)直接生成對(duì)應(yīng)的接口demo，可以選擇SDK下載，也可以選擇查看文檔，和官網(wǎng)文檔一模一樣。右側(cè)顯示調(diào)用結(jié)果成功之后，請(qǐng)復(fù)制返回結(jié)果access__token的值，用于后續(xù)的使用。使用APIExplorer<363.獲取用戶(hù)userId。通過(guò)調(diào)用/user/listsimple接口獲取用戶(hù)userId，獲取步驟如下：l單擊左側(cè)通訊錄管理，然后選擇查詢(xún)部門(mén)用戶(hù)簡(jiǎn)易信息接口。說(shuō)明：支持中英文模糊搜索。37>使用APIExplorerl填寫(xiě)相關(guān)參數(shù)信息，然后單擊發(fā)起調(diào)用。naccess__token：已生成的access__token。ncursor：分頁(yè)查詢(xún)的游標(biāo)，最開(kāi)始傳0。nsize：分頁(yè)長(zhǎng)度。說(shuō)明：右側(cè)顯示調(diào)用結(jié)果成功之后，請(qǐng)復(fù)制返回結(jié)果中對(duì)應(yīng)用戶(hù)的userid的值，用于后續(xù)的使用。4.點(diǎn)擊左側(cè)的待辦任務(wù)模塊，選擇新增待辦事項(xiàng)，填寫(xiě)待辦事項(xiàng)內(nèi)容，單擊發(fā)起調(diào)用。laccess__token：已獲取的access__token。luserId：已獲取的userId。lcreate__time：待辦時(shí)間。ltitle：待辦事項(xiàng)的標(biāo)題。lurl：待辦事項(xiàng)的跳轉(zhuǎn)鏈接。nformItemList：表單列表。title：表單標(biāo)題。content：表單內(nèi)容。使用APIExplorer<38調(diào)用成功后，在待辦中會(huì)顯示對(duì)應(yīng)的待辦任務(wù)，如下圖所示：39>使用JSAPIExplorer使用JSAPIExplorer簡(jiǎn)介：JSAPIExplorer是釘釘開(kāi)放平臺(tái)提供的可視化微應(yīng)用JSAPI調(diào)用工具，方便開(kāi)發(fā)者在線(xiàn)發(fā)起API調(diào)用。本文將以JSAPIExplorer工具調(diào)用時(shí)間選擇器API為例，幫助您快速了解JSAPIExplorer工具的使用。參考以下操作，實(shí)現(xiàn)JSAPIExplorer工具連接手機(jī)控制臺(tái)。1.打開(kāi)JSAPIExplorer工具，選擇左側(cè)日期&月歷，然后選擇時(shí)間選擇器。2.單擊發(fā)起調(diào)用，使用手機(jī)釘釘掃描二維碼連接控制臺(tái)。使用JSAPIExplorer<403.根據(jù)提示完成手機(jī)掃碼授權(quán)，單擊確定。41>使用JSAPIExplorer完成掃碼授權(quán)后如下圖所示，則表示連接成功。說(shuō)明：當(dāng)控制臺(tái)連接成功后，在沒(méi)有斷開(kāi)連接的前提下，調(diào)用其他API時(shí)可忽略步驟一，斷開(kāi)連接后需重新連接手機(jī)控制臺(tái)。參考以下操作，使用JSAPIExplorer工具完成時(shí)間選擇器API調(diào)用：1.填寫(xiě)format和value，然后單擊發(fā)起調(diào)用。lformat：時(shí)間格式，例如：HH:mm。lvalue：默認(rèn)顯示時(shí)間，例如：14:00。使用JSAPIExplorer<422.手機(jī)端選擇顯示時(shí)間后，單擊確定。說(shuō)明：Android端和iOS端不同系統(tǒng)展示結(jié)果可能會(huì)出現(xiàn)差別，請(qǐng)以最終的展示效果為準(zhǔn)。43>使用JSAPIExplorer3.手機(jī)端和PC端同時(shí)返回調(diào)用結(jié)果，效果如下圖所示。手機(jī)端效果圖：PC端效果圖：釘釘應(yīng)用開(kāi)發(fā)入門(mén)小程序簡(jiǎn)介：本文將以自動(dòng)免登并獲取用戶(hù)信息的釘釘小程簡(jiǎn)介：本文將以自動(dòng)免登并獲取用戶(hù)信息的釘釘小程序?yàn)槔?，幫助您快速了解企業(yè)自主開(kāi)發(fā)小程序的流程。參考以下步驟，在釘釘開(kāi)放平臺(tái)上創(chuàng)建企業(yè)內(nèi)部小程序，并完成基礎(chǔ)配置：1.使用釘釘開(kāi)發(fā)者賬號(hào)登錄開(kāi)發(fā)者后臺(tái)。說(shuō)明：只有管理員和子管理員可登錄開(kāi)發(fā)者后臺(tái)。2.在開(kāi)發(fā)者后臺(tái)頁(yè)面，單擊應(yīng)用開(kāi)發(fā)，然后選擇企業(yè)內(nèi)部開(kāi)發(fā)>小程序，最后單擊創(chuàng)建應(yīng)用。3.在彈出的創(chuàng)建應(yīng)用頁(yè)面中填寫(xiě)基本信息，然后單擊確定創(chuàng)建。l應(yīng)用類(lèi)型：選擇小程序。l開(kāi)發(fā)方式：選擇企業(yè)自助開(kāi)發(fā)。4.應(yīng)用創(chuàng)建完成后，在憑證與基礎(chǔ)信息頁(yè)面，復(fù)制應(yīng)用的AppKey和AppSecret備用。5.單擊開(kāi)發(fā)管理進(jìn)入開(kāi)發(fā)管理頁(yè)面，然后單擊修改，并根據(jù)以下內(nèi)容配置開(kāi)發(fā)信息。l服務(wù)器出口IP：輸入調(diào)用釘釘服務(wù)端API時(shí)使用的IP即企業(yè)服務(wù)器的公網(wǎng)IP，多個(gè)IP請(qǐng)以英文逗號(hào)","隔開(kāi)，支持帶一個(gè)*號(hào)通配符的IP格式。最多可設(shè)置20個(gè)，并且符合IPV4規(guī)則。lPC端首頁(yè)地址（可選輸入在PC端釘釘工作臺(tái)上打開(kāi)本應(yīng)用的地址。鏈接地址必須以http或https開(kāi)頭。l管理后臺(tái)地址（可選輸入組織管理員在釘釘管理后臺(tái)訪(fǎng)問(wèn)該應(yīng)用的地址。6.單擊人員管理，然后單擊添加人員添加開(kāi)發(fā)人員。說(shuō)明：應(yīng)用創(chuàng)建后，默認(rèn)開(kāi)發(fā)人員為應(yīng)用創(chuàng)建者。只有在這里添加了開(kāi)發(fā)人員，開(kāi)發(fā)人員才可以在小程序IDE中關(guān)聯(lián)這個(gè)應(yīng)用。7.單擊安全中心，然后單擊添加添加一個(gè)HTTP安全域名。安全域名是后端服務(wù)部署的服務(wù)器的公網(wǎng)IP或域名。當(dāng)小程序的前端與服務(wù)端需要進(jìn)行網(wǎng)絡(luò)通信時(shí)，需要設(shè)置安全域名。小程序前端只能通過(guò)已設(shè)置的安全域名（或IP）與服務(wù)端進(jìn)行網(wǎng)絡(luò)通信。當(dāng)安全域名更新時(shí)，需要在小程序開(kāi)發(fā)工具重新打包上傳版本，設(shè)置的域名才會(huì)生效。8.單擊權(quán)限管理進(jìn)入權(quán)限管理頁(yè)面，然后根據(jù)以下配置添加接口調(diào)用權(quán)限。說(shuō)明權(quán)限管理主要包含基礎(chǔ)權(quán)限、高級(jí)權(quán)限-微應(yīng)用、高級(jí)權(quán)限-企業(yè)通訊錄三個(gè)部分，還包括特殊權(quán)限申請(qǐng)。建議開(kāi)發(fā)者自助按需申請(qǐng)接口權(quán)限，合理設(shè)置權(quán)限的范圍。本教程中需要調(diào)用接口獲取用戶(hù)的姓名和userid，所以需要先添加通訊錄接口權(quán)限。l權(quán)限范圍選擇全部員工，然后單擊添加接口權(quán)限。l選擇通訊錄>通訊錄只讀權(quán)限，單擊確認(rèn)。創(chuàng)建應(yīng)用成功后，參考以下步驟完成服務(wù)端代碼的配置部署：1.下載服務(wù)端代碼。gitgitclone/open-dingtalk/org-mini-program-tutorial-java.git2.導(dǎo)入服務(wù)端代碼。l運(yùn)行IntelliJIDEA，然后在啟動(dòng)頁(yè)面單擊Open。l將下載好的服務(wù)端代碼導(dǎo)入到項(xiàng)目工程。l單擊OK，完成服務(wù)端的部署。3.配置服務(wù)端代碼。修改src/main/java/com/dingtalk/constant/AppConstant.java文件中參數(shù)值。lAppKey：應(yīng)用的唯一身份標(biāo)識(shí)，填寫(xiě)創(chuàng)建應(yīng)用時(shí)復(fù)制的AppKey。lAppSecret：對(duì)應(yīng)的調(diào)用密鑰，填寫(xiě)創(chuàng)建應(yīng)用時(shí)復(fù)制的AppSecret。4.啟動(dòng)后端服務(wù)。打開(kāi)src/main/java/com/dingtalk/Application.java文件，運(yùn)行后端服務(wù)。5.在瀏覽器中訪(fǎng)問(wèn)http://localhost:8080/welcome檢查服務(wù)是否啟動(dòng)成功。顯示如下頁(yè)面表示啟動(dòng)成功。服務(wù)端代碼配置部署成功后，參考以下步驟完成小程序前端代碼的配置部署：1.下載前端代碼。gitgitclone/open-dingtalk/org-mini-program-tutorial-front-end.git2.導(dǎo)入前端代碼。小程序IDE工具，然后選擇已下載的小程序項(xiàng)目，項(xiàng)目類(lèi)型選擇釘釘>企業(yè)內(nèi)部應(yīng)用，點(diǎn)擊完成。3.登陸IDE工具。打開(kāi)釘釘APP，掃碼頁(yè)面上的二維碼。4.關(guān)聯(lián)已創(chuàng)建的小程序應(yīng)用小程序Demo。說(shuō)明：如果無(wú)法關(guān)聯(lián)小程序，登錄開(kāi)發(fā)者后臺(tái)，檢查開(kāi)發(fā)人員是否已添加到應(yīng)用的人員管理列表。5.配置前端代碼。打開(kāi)org-mini-program-tutorial-front-end/page/index/index.js文件修改配置信息。注意URL中的IP或者域名必須是開(kāi)發(fā)者后臺(tái)臺(tái)中設(shè)置的本應(yīng)用的安全域名。ldomain：開(kāi)發(fā)者后臺(tái)設(shè)置的安全域名。lurl：服務(wù)端接口訪(fǎng)問(wèn)路徑。6.單擊點(diǎn)擊登錄調(diào)試小程序，查看是否可以成功獲取登錄信息。前端代碼配置部署成功后，參考以下步驟完成上傳和發(fā)布小程序：1.單擊上傳，確認(rèn)小程序版本，然后再次單擊上傳。2.上傳成功后，打開(kāi)開(kāi)發(fā)者后臺(tái)，在應(yīng)用詳情頁(yè)面，單擊版本管理與發(fā)布，然后選擇已上傳的版本，再單擊發(fā)布。3.默認(rèn)發(fā)布后企業(yè)內(nèi)部成員可使用該版本的應(yīng)用。您可以選擇使用該應(yīng)用的用戶(hù)范圍，然后單擊保存修改。H5微應(yīng)用簡(jiǎn)介：本文將以獲取當(dāng)前用戶(hù)部門(mén)信息的H5微應(yīng)用為例簡(jiǎn)介：本文將以獲取當(dāng)前用戶(hù)部門(mén)信息的H5微應(yīng)用為例，幫助您快速了解釘釘H5微應(yīng)用的開(kāi)發(fā)流程。參考以下步驟，在釘釘開(kāi)放平臺(tái)上創(chuàng)建企業(yè)內(nèi)部H5微應(yīng)用，并完成基礎(chǔ)配置：1.使用釘釘開(kāi)發(fā)者賬號(hào)登錄開(kāi)發(fā)者后臺(tái)。說(shuō)明：只有管理員和子管理員可登錄開(kāi)發(fā)者后臺(tái)。2.在開(kāi)發(fā)者后臺(tái)頁(yè)面，單擊應(yīng)用開(kāi)發(fā)，然后選擇企業(yè)內(nèi)部開(kāi)發(fā)>H5微應(yīng)用，最后單擊創(chuàng)建應(yīng)用。3.在彈出的創(chuàng)建應(yīng)用頁(yè)面中填寫(xiě)基本信息，然后單擊確定創(chuàng)建。l應(yīng)用類(lèi)型：選擇H5微應(yīng)用。l開(kāi)發(fā)方式：選擇企業(yè)自助開(kāi)發(fā)。4.應(yīng)用創(chuàng)建完成后，在憑證與基礎(chǔ)信息頁(yè)面，復(fù)制應(yīng)用的AgentId、AppKey和AppSecret備用。5.單擊開(kāi)發(fā)管理進(jìn)入開(kāi)發(fā)管理頁(yè)面，然后單擊修改，并根據(jù)以下內(nèi)容配置開(kāi)發(fā)信息。l開(kāi)發(fā)模式：選擇開(kāi)發(fā)應(yīng)用。注意：如果選擇了快捷鏈接，創(chuàng)建完應(yīng)用以后不會(huì)生成AppKey，也意味著創(chuàng)建的應(yīng)用無(wú)法調(diào)用釘釘?shù)姆?wù)端接口，也無(wú)法調(diào)用釘釘?shù)那岸私涌凇服務(wù)器出口IP：輸入調(diào)用釘釘服務(wù)端API時(shí)使用的IP即企業(yè)服務(wù)器的公網(wǎng)IP，多個(gè)IP請(qǐng)以英文逗號(hào)","隔開(kāi)，支持帶一個(gè)*號(hào)通配符的IP格式。最多可以設(shè)置20個(gè)，符合IPV4規(guī)則。l應(yīng)用首頁(yè)地址：輸入應(yīng)用首頁(yè)URL，在移動(dòng)端工作臺(tái)點(diǎn)擊應(yīng)用圖標(biāo)會(huì)跳轉(zhuǎn)到此頁(yè)面。可輸入后端服務(wù)部署的服務(wù)器的IP或域名。6.單擊權(quán)限管理進(jìn)入權(quán)限管理頁(yè)面，然后根據(jù)以下配置添加接口調(diào)用權(quán)限。說(shuō)明權(quán)限管理主要包含基礎(chǔ)權(quán)限、高級(jí)權(quán)限-微應(yīng)用、高級(jí)權(quán)限-企業(yè)通訊錄三個(gè)部分，還包括特殊權(quán)限申請(qǐng)。建議開(kāi)發(fā)者自助按需申請(qǐng)接口權(quán)限，合理設(shè)置權(quán)限的范圍。l權(quán)限范圍選擇全部員工，然后單擊添加接口權(quán)限。l選擇通訊錄權(quán)限，單擊確認(rèn)。創(chuàng)建應(yīng)用成功后，參考以下操作完成服務(wù)部署：1.下載服務(wù)端代碼。gitgitclone/open-dingtalk/org-H5-application-tutorial.git2.導(dǎo)入服務(wù)端代碼。l運(yùn)行IntelliJIDEA，然后在啟動(dòng)頁(yè)面單擊Open。l將下載好的服務(wù)端代碼導(dǎo)入到項(xiàng)目工程。l單擊OK，完成服務(wù)端的部署。3.配置服務(wù)端代碼。修改backend/src/main/resources/perties文件中的參數(shù)值。ldingtalk.app__key：應(yīng)用的唯一身份標(biāo)識(shí)，填寫(xiě)創(chuàng)建應(yīng)用時(shí)復(fù)制的AppKey。ldingtalk.app__secret：對(duì)應(yīng)的調(diào)用密鑰，填寫(xiě)創(chuàng)建應(yīng)用時(shí)復(fù)制的AppSecret。ldingtalk.agent__id：微應(yīng)用ID，填寫(xiě)創(chuàng)建應(yīng)用時(shí)復(fù)制的AgentId。ldingtalk.corp__id：應(yīng)用所屬的CorpId。CorpId可以在開(kāi)發(fā)者后臺(tái)首頁(yè)獲取。4.啟動(dòng)后端服務(wù)。打開(kāi)backend/src/main/java/com/dingtalk/Application.java文件，運(yùn)行后端服務(wù)。5.在瀏覽器中訪(fǎng)問(wèn)http://localhost:8080/welcome檢查服務(wù)是否啟動(dòng)成功。顯示如下頁(yè)面表示啟動(dòng)成功。后端服務(wù)啟動(dòng)成功后，參考以下步驟完成測(cè)試并發(fā)布H5微應(yīng)用。1.登錄開(kāi)發(fā)者后臺(tái)，單擊已創(chuàng)建的H5微應(yīng)用。2.在應(yīng)用詳情頁(yè)，單擊版本管理與發(fā)布，然后單擊添加添加可測(cè)試微應(yīng)用的人員。3.在釘釘手機(jī)客戶(hù)端打開(kāi)工作臺(tái)，切換到應(yīng)用的所屬組織，然后打開(kāi)創(chuàng)建的H5微應(yīng)用。4.能夠正常顯示當(dāng)前用戶(hù)的部門(mén)信息（如下圖所示表示微應(yīng)用已成功部署。5.發(fā)布應(yīng)用完成測(cè)試后，登錄開(kāi)發(fā)者后臺(tái)，在應(yīng)用詳情頁(yè)單擊版本管理與發(fā)布，然后單擊確認(rèn)發(fā)布。應(yīng)用發(fā)布后，該應(yīng)用將會(huì)出現(xiàn)在釘釘?shù)墓ぷ髋_(tái)上，企業(yè)組織內(nèi)部的用戶(hù)將會(huì)看到該應(yīng)用。API實(shí)戰(zhàn)同步打卡數(shù)據(jù)簡(jiǎn)介：本教程指導(dǎo)你如何調(diào)用創(chuàng)建一個(gè)H5微應(yīng)用，然后簡(jiǎn)介：本教程指導(dǎo)你如何調(diào)用創(chuàng)建一個(gè)H5微應(yīng)用，然后使用這個(gè)應(yīng)用獲取用戶(hù)打卡結(jié)果。在開(kāi)始本教程前，確保你已經(jīng)完成了以下準(zhǔn)備工作：l你已經(jīng)完成了釘釘開(kāi)發(fā)者的注冊(cè)與激活并擁有了子管理員和開(kāi)發(fā)者權(quán)限。若尚未完成，請(qǐng)參考成為釘釘開(kāi)發(fā)者。l已經(jīng)安裝了Java開(kāi)發(fā)環(huán)境。若未安裝，請(qǐng)?jiān)L問(wèn)Oracle官網(wǎng)下載。l已下載并安裝了IntelliJIDEA工具。若未安裝，請(qǐng)?jiān)L問(wèn)IntelliJIDEA。二、創(chuàng)建Java工程并安裝釘釘JavaSDK在本部分，你將創(chuàng)建一個(gè)Java工程并完成釘釘JavaSDK的安裝。1.打開(kāi)IntelliJIDEA工具。2.單擊選擇Projects，然后單擊NewProject。3.參考下圖，選擇Maven項(xiàng)目和JDK版本，然后單擊Next。4.輸入項(xiàng)目名稱(chēng)，然后單擊Finish。5.單擊這里下載釘釘服務(wù)端JavaSDK。6.解壓dingtalk-sdk-java.zip。7.在IntelliJIDEA工具的頂部菜單欄中，選擇File>ProjectStructure。8.選擇ProjectSettings>Libraries，然后依次單擊“+”>Java。9.選中下載的SDK，然后依次單擊OK>Apply完成導(dǎo)入。在本部分，你將在開(kāi)發(fā)者后臺(tái)創(chuàng)建一個(gè)H5微應(yīng)用，并完成基礎(chǔ)配置。1.登錄釘釘開(kāi)發(fā)者后臺(tái)。說(shuō)明：只有管理員和子管理員可登錄開(kāi)發(fā)者后臺(tái)。2.在開(kāi)發(fā)者后臺(tái)頁(yè)面，單擊應(yīng)用開(kāi)發(fā)，然后選擇企業(yè)內(nèi)部開(kāi)發(fā)>小程序，最后單擊創(chuàng)建應(yīng)用。3.在彈出的創(chuàng)建應(yīng)用頁(yè)面中填寫(xiě)基本信息，然后單擊確定創(chuàng)建。l應(yīng)用類(lèi)型：選擇H5微應(yīng)用。l開(kāi)發(fā)方式：選擇企業(yè)自助開(kāi)發(fā)。4.應(yīng)用創(chuàng)建完成后，在憑證與基礎(chǔ)信息頁(yè)面，復(fù)制應(yīng)用的AppKey和AppSecret備用。5.單擊開(kāi)發(fā)管理進(jìn)入開(kāi)發(fā)管理頁(yè)面，然后單擊修改，并根據(jù)以下內(nèi)容配置開(kāi)發(fā)信息。l開(kāi)發(fā)模式：選擇開(kāi)發(fā)應(yīng)用。l服務(wù)器出口IP：輸入調(diào)用釘釘服務(wù)端API時(shí)使用的IP即企業(yè)服務(wù)器的公網(wǎng)IP，多個(gè)IP請(qǐng)以英文逗號(hào)","隔開(kāi)，支持帶一個(gè)*號(hào)通配符的IP格式。可通過(guò)工具進(jìn)行查看。本教程設(shè)置為。l應(yīng)用首頁(yè)地址：輸入應(yīng)用首頁(yè)URL，在移動(dòng)端工作臺(tái)點(diǎn)擊應(yīng)用圖標(biāo)會(huì)跳轉(zhuǎn)到此頁(yè)面?？奢斎牒蠖朔?wù)部署的服務(wù)器的IP或域名。例如：http://公網(wǎng)IP:8080。本教程設(shè)置為/。6.單擊權(quán)限管理進(jìn)入權(quán)限管理頁(yè)面，然后根據(jù)以下配置添加接口調(diào)用權(quán)限。l權(quán)限范圍選擇全部員工，然后單擊添加接口權(quán)限。l選擇考勤權(quán)限，單擊確認(rèn)。在本部分，你將通過(guò)創(chuàng)建的應(yīng)用的AppKey和AppSecret獲取調(diào)用釘釘服務(wù)端API的調(diào)用憑證access__token。1.如下圖所示，在項(xiàng)目的src/test/java/目錄下新建一個(gè)AccessTokenUtil測(cè)試類(lèi)。2.在AccessTokenUtil類(lèi)中添加以下代碼，并運(yùn)行。調(diào)用gettoken接口獲取服務(wù)端API授權(quán)憑證access__token。importimportcom.dingtalk.api.DefaultDingTalkClient;importcom.dingtalk.api.request.OapiGettokenRequest;importcom.dingtalk.api.response.OapiGettokenResponse;importcom.taobao.api.ApiException;publicclassAccessTokenUtil{publicstaticStringAppKey="替換為你應(yīng)用的publicstaticStringAppSecret="替換為你應(yīng)用的AppSecret";publicstaticStringgetToken()throwsRuntimeException{DefaultDingTalkClientclient=newDefaultDingTalkClient("/gettoken");OapiGettokenRequestrequest=newOapiGettokenRequest();request.setAppkey(AppKey);request.setAppsecret(AppSecret);request.setHttpMethod("GET");OapiGettokenResponseresponse=client.execute(request);StringaccessToken=response.getAccessToken();returnaccessToken;}catch(ApiExceptione){thrownewRuntimeException();}}publicstaticvoidmain(String[]args)throwsApiException{StringaccessToken=AccessTokenUtil.getToken();System.out.println(accessToken);}}3.調(diào)用成功的返回結(jié)果類(lèi)似如下。efcfbefcfb3d7f6aa3abxxx在本部分，你將通過(guò)服務(wù)端API的調(diào)用憑證access__token從釘釘后臺(tái)獲取考勤打卡記錄。1.如下圖所示，在項(xiàng)目的src/test/java/目錄下新建一個(gè)AttendanceDemo測(cè)試類(lèi)。2.在AttendanceDemo類(lèi)中添加以下代碼，并運(yùn)行。調(diào)用/attendance/list接口，獲取企業(yè)內(nèi)員工的實(shí)際打卡結(jié)果。importimportcom.dingtalk.api.DefaultDingTalkClient;importcom.dingtalk.api.DingTalkClient;importcom.dingtalk.api.request.OapiAttendanceListRequest;importcom.dingtalk.api.response.OapiAttendanceListResponse;importcom.taobao.api.ApiException;importjava.util.Arrays;publicclassAttendanceDemo{**@paramargspublicstaticvoidmain(Stringargs[]){//獲取服務(wù)端接口調(diào)用憑證access_tokenStringaccess_token=AccessTokenUtil.getToken();DingTalkClientclient=newDefaultDingTalkClient("/attendance/OapiAttendanceListRequestrequest=newOapiAttendanceListRequest();request.setWorkDateFrom("2021-01-1200:00:00");request.setWorkDateTo("2021-01-1900:00:00");request.setUserIdList(Arrays.asList("user123"));request.setOffset(0L);/request.setLimit(1L);OapiAttendanceListResponseresponse=client.execute(request,access_token);System.out.println(response.getBody());}catch(ApiExceptione){e.printStackTrace();}}}3.調(diào)用成功的返回結(jié)果類(lèi)似如下。{{"errcode":0,"recordresult":[{"checkType":"OnDuty","corpId":"dinge8a56572f80xxxx","baseCheckTime":1610380800000,"recordId":54735159894,"workDate":1610380800000,"sourceType":"ATM","userCheckTime":1610380800000,"planId":180485053237,}],"_record":"77964B20FC00","hasMore":false,}4.此時(shí)，你就可以將打卡結(jié)果同步到自有的OA系統(tǒng)中了。你已完成本教程的全部?jī)?nèi)容！現(xiàn)在你已經(jīng)擁有一個(gè)可以正常運(yùn)行的釘釘應(yīng)用。你也可以在其中添加其他功能，參考應(yīng)用開(kāi)發(fā)了解更多。搭建審批工作流簡(jiǎn)介：本教程以一個(gè)簡(jiǎn)單的出差審批工作流為例展示如何發(fā)起一個(gè)簡(jiǎn)介：本教程以一個(gè)簡(jiǎn)單的出差審批工作流為例展示如何發(fā)起一個(gè)審批。為了方便開(kāi)發(fā)者體驗(yàn)，我們提供了服務(wù)端和前端代碼，您只需要根據(jù)本文檔的操作，完成基礎(chǔ)配置既可。在開(kāi)始接入前，確保您已經(jīng)完成以下準(zhǔn)備工作：l安裝小程序IDE，單擊小程序開(kāi)發(fā)工具下載。l已下載并安裝了IntelliJIDEA開(kāi)發(fā)工具。若未安裝，請(qǐng)?jiān)L問(wèn)IntelliJIDEA。l已經(jīng)安裝了Java開(kāi)發(fā)環(huán)境。若未安裝，請(qǐng)?jiān)L問(wèn)Oracle官網(wǎng)下載。l已經(jīng)安裝了Java項(xiàng)目構(gòu)建工具M(jìn)aven。若未安裝，請(qǐng)?jiān)L問(wèn)ApacheMaven下載。l已經(jīng)安裝了項(xiàng)目管理工具Git。若未安裝，請(qǐng)?jiān)L問(wèn)Git官網(wǎng)下載。在本部分，你將在開(kāi)發(fā)者后臺(tái)創(chuàng)建一個(gè)H5微應(yīng)用，并完成基礎(chǔ)配置。1.登錄釘釘開(kāi)發(fā)者后臺(tái)。說(shuō)明：只有管理員和子管理員可登錄開(kāi)發(fā)者后臺(tái)。2.在開(kāi)發(fā)者后臺(tái)頁(yè)面，單擊應(yīng)用開(kāi)發(fā)，然后選擇企業(yè)內(nèi)部開(kāi)發(fā)>小程序，最后單擊創(chuàng)建應(yīng)用。3.在彈出的創(chuàng)建應(yīng)用頁(yè)面中填寫(xiě)基本信息，然后單擊確定創(chuàng)建。l應(yīng)用類(lèi)型：選擇小程序。l開(kāi)發(fā)方式：選擇企業(yè)自助開(kāi)發(fā)。4.應(yīng)用創(chuàng)建完成后，在憑證與基礎(chǔ)信息頁(yè)面，復(fù)制應(yīng)用的AppKey、AppSecret和AgentId備用。5.單擊開(kāi)發(fā)管理進(jìn)入開(kāi)發(fā)管理頁(yè)面，然后單擊修改，并根據(jù)以下內(nèi)容配置開(kāi)發(fā)信息。l服務(wù)器出口IP：輸入調(diào)用釘釘服務(wù)端API時(shí)使用的IP即企業(yè)服務(wù)器的公網(wǎng)IP，多個(gè)IP請(qǐng)以英文逗號(hào)","隔開(kāi)，支持帶一個(gè)*號(hào)通配符的IP格式。可通過(guò)工具進(jìn)行查看。本教程設(shè)置為。lPC端首頁(yè)地址（可選輸入在PC端釘釘工作臺(tái)上打開(kāi)本應(yīng)用的地址。鏈接地址必須以http或https開(kāi)頭。本教程設(shè)置為：/。l管理后臺(tái)地址（可選輸入組織管理員在釘釘管理后臺(tái)訪(fǎng)問(wèn)該應(yīng)用的地址。6.單擊人員管理，然后單擊添加人員添加開(kāi)發(fā)人員。說(shuō)明：應(yīng)用創(chuàng)建后，默認(rèn)開(kāi)發(fā)人員為應(yīng)用創(chuàng)建者。7.單擊安全中心，然后單擊添加添加一個(gè)HTTP安全域名。l當(dāng)小程序的前端與服務(wù)端需要進(jìn)行網(wǎng)絡(luò)通信時(shí)，需要設(shè)置安全域名。小程序前端只能通過(guò)已設(shè)置的安全域名（或IP）與服務(wù)端進(jìn)行網(wǎng)絡(luò)通信。當(dāng)安全域名更新時(shí)，需要在小程序開(kāi)發(fā)工具重新打包上傳版本，設(shè)置的域名才會(huì)生效。l安全域名是后端服務(wù)部署的服務(wù)器的公網(wǎng)IP或域名，本教程輸入。8.單擊權(quán)限管理進(jìn)入權(quán)限管理頁(yè)面，然后根據(jù)以下配置添加接口調(diào)用權(quán)限。l權(quán)限范圍選擇全部員工，然后單擊添加接口權(quán)限。l選擇通訊錄和審批接口權(quán)限。在本部分，你將在OA管理后臺(tái)創(chuàng)建審批模板。1.使用管理員賬號(hào)登錄OA管理后臺(tái)，然后選擇工作臺(tái)>OA審批。2.在表單管理頁(yè)面，單擊創(chuàng)建新表單，然后選擇自定義流程表單。3.在基礎(chǔ)配置頁(yè)面，完成基礎(chǔ)信息配置。4.單擊表單設(shè)計(jì)，然后在控件庫(kù)中根據(jù)下表設(shè)計(jì)出差申請(qǐng)表單，并保存url中的processCode。說(shuō)明：拖拽控件后，需要修改控件標(biāo)題。表單項(xiàng)使用控件行程明細(xì)明細(xì)/表格控件出差地點(diǎn)單行輸入框控件圖片圖片控件開(kāi)始時(shí)間，結(jié)束時(shí)間日期區(qū)間控件出差人數(shù)數(shù)字控件出差金額金額控件出差同伴單選框控件（添加的時(shí)候，把選項(xiàng)改為A,B,C）交通工具單行輸入框控件出差事由多行輸入框控件注意：切記保存好processCode，在服務(wù)端開(kāi)發(fā)時(shí)需要該參數(shù)。5.單擊流程設(shè)計(jì)，單擊+設(shè)置審批條件和審批人，如下圖所示。6.流程設(shè)計(jì)完成后，單擊發(fā)布完成表單設(shè)計(jì)。在本部分你將下載服務(wù)端代碼，并完成基礎(chǔ)配置。參考以下操作，完成服務(wù)端開(kāi)發(fā)：1.執(zhí)行以下代碼，下載服務(wù)端代碼。gitgitclone/opendingtalk2.使用IntelliJIDEA打開(kāi)下載的代碼工程，并修改配置：l運(yùn)行IntelliJIDEA，然后在啟動(dòng)頁(yè)面單擊Open。l選擇剛剛下載的服務(wù)端代碼，然后單擊OK。l打開(kāi)src/main/java/com/config/Constant.java文件，修改以下信息。*/publicstaticfinalStringCORP_ID="***";*應(yīng)用的AppKey，登錄開(kāi)發(fā)者后臺(tái)，點(diǎn)擊應(yīng)用管理，進(jìn)入應(yīng)用詳情可見(jiàn)publicstaticfinalStringAPPKEY="***";*應(yīng)用的AppSecret，登錄開(kāi)發(fā)者后臺(tái)，點(diǎn)擊應(yīng)用管理，進(jìn)入應(yīng)用詳情可見(jiàn)publicstaticfinalStringAPPSECRET="***";*數(shù)據(jù)加密密鑰。用于回調(diào)數(shù)據(jù)的加密，長(zhǎng)度固定為43個(gè)字符，從a-z,A-Z,0-9共62個(gè)字符中選取,您可以隨機(jī)生成*/publicstaticfinalStringENCODING_AES_KEY="***";*加解密需要用到的token，企業(yè)可以publicstaticfinalStringTOKEpublicstaticfinalLongAGENTID=111L;publicstaticfinalStringPROCESS_CODE="***";3.參考以下操作，部署后端服務(wù)。l打開(kāi)src/main/java/com/Application.java文件。l使用快捷鍵ctrl+shift+f10，運(yùn)行后端4.服務(wù)端啟動(dòng)后，在瀏覽器中訪(fǎng)問(wèn)http://localhost:8080/welcome，打開(kāi)如下頁(yè)面表示啟動(dòng)成功。在本部分你將下載前端代碼，并完成基礎(chǔ)配置。參考以下操作，完成前端開(kāi)發(fā)：1.執(zhí)行以下命令，下載前端代碼。gitgitclone/opendingtalk/eapp-corp-project-fe2.打開(kāi)小程序IDE開(kāi)發(fā)工具，打開(kāi)已下載的項(xiàng)目。說(shuō)明：項(xiàng)目類(lèi)型選擇釘釘企業(yè)內(nèi)部應(yīng)用。3.關(guān)聯(lián)步驟一中創(chuàng)建的小程序應(yīng)用。4.打開(kāi)eapp-corp-project-fe/page/index/index.js文件修改服務(wù)端URL，URL中的IP或者域名必須是開(kāi)發(fā)者后臺(tái)中設(shè)置的本應(yīng)用的安全域名。小程序前端發(fā)起網(wǎng)絡(luò)請(qǐng)求時(shí)是直連安全域名或IP的。本示例中設(shè)置為:8080。5.單擊發(fā)起審批即可發(fā)起一個(gè)審批實(shí)例。為了保持代碼的簡(jiǎn)潔，本次demo發(fā)起的審批實(shí)例中，審批發(fā)起人、審批人和抄送人是同一個(gè)用戶(hù)，即當(dāng)前免登的用戶(hù)。6.打開(kāi)釘釘打開(kāi)移動(dòng)端或PC端釘釘，找到該企業(yè)工作通知，查看收到的審批通知。你已完成本教程的全部?jī)?nèi)容！現(xiàn)在你已經(jīng)擁有一個(gè)可以正常運(yùn)行的釘釘小程序。你也可以在其中添加其他功能，參考應(yīng)用開(kāi)發(fā)了解更多。你還還可以通過(guò)以下方式注冊(cè)審批事件。l注冊(cè)回調(diào)你可以通過(guò)以下方法注冊(cè)或更新企業(yè)的回調(diào)地址：n打開(kāi)已下載的服務(wù)端代碼，修改服務(wù)端代碼Constant.java文件中的CALLBACK__URL__HOST參數(shù)，設(shè)置成你的回調(diào)地址。n運(yùn)行CallbackController中的main方法，注冊(cè)或更新企業(yè)的回調(diào)地址。n當(dāng)控制臺(tái)打印出回調(diào)注冊(cè)成功了！??！時(shí)，表示注冊(cè)回調(diào)成功。l接收審批回調(diào)n注冊(cè)完審批回調(diào)，當(dāng)審批被通過(guò)或拒絕時(shí)，服務(wù)端會(huì)接收到對(duì)應(yīng)的回調(diào)通知，您可以結(jié)合您的業(yè)務(wù)場(chǎng)景做相應(yīng)的處理。在本示例中，服務(wù)端接收回調(diào)后，會(huì)給審批發(fā)起人發(fā)一條工作通知消息。釘釘能力概覽服務(wù)端API簡(jiǎn)介：為滿(mǎn)足開(kāi)發(fā)者基于釘釘進(jìn)行應(yīng)用開(kāi)發(fā)的需求簡(jiǎn)介：為滿(mǎn)足開(kāi)發(fā)者基于釘釘進(jìn)行應(yīng)用開(kāi)發(fā)的需求，釘釘開(kāi)放平臺(tái)為用戶(hù)提供服務(wù)端API和前端API共500多個(gè)接口給開(kāi)發(fā)者使用。服務(wù)端APIAPI說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用獲取企業(yè)內(nèi)部應(yīng)用的access__token獲取企業(yè)內(nèi)部應(yīng)用的access__token企業(yè)內(nèi)部應(yīng)用調(diào)用本接口獲取access__token。支持不支持不支持獲取第三方應(yīng)用授權(quán)企業(yè)的access__token獲取第三方應(yīng)用授權(quán)企業(yè)的access__token定制服務(wù)商應(yīng)用和服務(wù)商可通過(guò)此接口獲取授權(quán)企業(yè)的access__token。支持支持不支持獲取第三方企業(yè)應(yīng)用的suite__acess__token獲取第三方企業(yè)應(yīng)用的suite__access__token。不支持支持不支持獲取jsapi__ticket獲取jsapi__ticket。支持支持不支持獲取微應(yīng)用后臺(tái)免登的access__token獲取微應(yīng)用后臺(tái)免登的access支持支持不支持身份驗(yàn)證（免登）API名稱(chēng)說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用通過(guò)免登碼獲取用戶(hù)信息通過(guò)access__token和免登接口中獲取的code來(lái)獲取用戶(hù)userid。支持支持不支持通過(guò)免登碼獲取用戶(hù)信息(v2)通過(guò)access__token和免登接口中獲取的code來(lái)獲取用戶(hù)userid。支持支持不支持獲取微應(yīng)用管理員的身份信息通過(guò)access__token和獲取到的免登授權(quán)碼code來(lái)?yè)Q取微應(yīng)用管理員的身份信息。支持支持不支持根據(jù)sns臨時(shí)授權(quán)碼獲取用戶(hù)信息根據(jù)sns臨時(shí)授權(quán)碼獲取用戶(hù)信息。不支持不支持支持HTTP回調(diào)API說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用注冊(cè)回調(diào)事件注冊(cè)回調(diào)事件。支持支持不支持獲取推送失敗的事件列表獲取推送失敗的變更事件。支持支持不支持更新事件接口更新已經(jīng)注冊(cè)的回調(diào)事件。支持支持不支持查詢(xún)訂閱事件查詢(xún)已經(jīng)注冊(cè)的回調(diào)事件。支持支持不支持刪除事件回調(diào)接口刪除事件回調(diào)接口。支持支持不支持93>服務(wù)端APIAPI說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用激活應(yīng)用在收到HTTP回調(diào)推送的企業(yè)授權(quán)開(kāi)通應(yīng)用事件后，激活企業(yè)授權(quán)的應(yīng)用。不支持支持不支持獲取授權(quán)應(yīng)用的基本信息獲取已授權(quán)開(kāi)通的企業(yè)的指定應(yīng)用的基本信息。不支持支持不支持獲取企業(yè)授權(quán)信息獲取企業(yè)授權(quán)信息。支持支持不支持獲取授權(quán)企業(yè)的永久授權(quán)碼獲取企業(yè)的永久授權(quán)碼。不支持支持不支持獲取應(yīng)用未激活的企業(yè)列表獲取應(yīng)用未激活的企業(yè)列表。不支持支持不支持重新授權(quán)未激活應(yīng)用的企業(yè)重新授權(quán)未激活應(yīng)用的企業(yè)。不支持支持不支持類(lèi)目API說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用獲取通訊錄權(quán)限范圍獲取通訊錄權(quán)限范圍獲取通訊錄權(quán)限范圍。支持支持不支持用戶(hù)管理（1.0）創(chuàng)建用戶(hù)創(chuàng)建新用戶(hù)。支持不支持不支持刪除用戶(hù)刪除指定用戶(hù)。支持不支持不支持更新用戶(hù)詳情更新用戶(hù)詳情。支持不支持不支持根據(jù)手機(jī)號(hào)獲取userid獲取用戶(hù)的userid。支持不支持不支持根據(jù)userid獲取用戶(hù)詳情根據(jù)userid獲取用戶(hù)詳情。支持支持不支持獲取部門(mén)用戶(hù)userid列表根據(jù)部門(mén)ID獲取指定部門(mén)的userid列表。支持支持不支持獲取部門(mén)用戶(hù)列表獲取部門(mén)下的用戶(hù)列表。支持支持不支持獲取部門(mén)用戶(hù)詳情獲取部門(mén)用戶(hù)詳情。支持支持不支持根據(jù)unionid獲取userid根據(jù)unionid獲取用戶(hù)的user支持支持不支持獲取企業(yè)員工人數(shù)獲取企業(yè)員工的人數(shù)。支持支持不支持獲取未登錄釘釘?shù)膯T工列表查詢(xún)指定日期內(nèi)未登錄釘釘?shù)钠髽I(yè)員工列表。支持不支持不支持獲取管理員列表獲取管理員列表。支持支持不支持獲取管理員通訊錄權(quán)限范圍獲取管理員通訊錄權(quán)限范圍。支持支持不支持獲取管理員的應(yīng)用管理權(quán)限獲取管理員的應(yīng)用管理權(quán)限。不支持支持不支持用戶(hù)管理（2.0）創(chuàng)建用戶(hù)創(chuàng)建新用戶(hù)。支持不支持不支持更新用戶(hù)信息更新指定的用戶(hù)信息。支持不支持不支持刪除用戶(hù)刪除指定用戶(hù)。支持不支持不支持根據(jù)userid獲取用戶(hù)詳情獲取指定用戶(hù)的詳細(xì)信息。支持支持不支持獲取部門(mén)用戶(hù)基礎(chǔ)信息獲取指定部門(mén)的用戶(hù)userid和name。支持支持不支持獲取部門(mén)用戶(hù)userid列表獲取指定部門(mén)的userid列表。支持支持不支持獲取部門(mén)用戶(hù)詳情獲取指定部門(mén)中的用戶(hù)詳細(xì)信息。支持支持不支持95>服務(wù)端API獲取員工人數(shù)獲取員工人數(shù)。支持支持不支持獲取未登錄釘釘?shù)膯T工列表查詢(xún)指定日期內(nèi)未登錄釘釘?shù)钠髽I(yè)員工列表。支持不支持不支持獲取管理員列表查詢(xún)管理員列表。支持支持不支持獲取管理員通訊錄權(quán)限范圍獲取管理員通訊錄權(quán)限范圍。支持支持不支持獲取管理員的應(yīng)用管理權(quán)限獲取管理員的應(yīng)用管理權(quán)限。不支持支持不支持根據(jù)手機(jī)號(hào)獲取userid根據(jù)手機(jī)號(hào)獲取用戶(hù)的use支持支持不支持根據(jù)unionid獲取用戶(hù)userid根據(jù)unionid獲取用戶(hù)的userid。支持支持不支持部門(mén)管理（1.0）創(chuàng)建部門(mén)創(chuàng)建新部門(mén)。支持不支持不支持刪除部門(mén)根據(jù)部門(mén)ID刪除指定部門(mén)。支持不支持不支持更新部門(mén)更新部門(mén)信息。支持不支持不支持獲取部門(mén)詳情獲取部門(mén)詳細(xì)信息。支持支持不支持獲取部門(mén)列表獲取部門(mén)列表信息。支持支持不支持獲取子部門(mén)ID列表獲取子部門(mén)ID列表。支持支持不支持查詢(xún)部門(mén)的所有上級(jí)父部門(mén)路徑查詢(xún)指定部門(mén)的所有上級(jí)父部門(mén)路徑。支持支持不支持查詢(xún)指定用戶(hù)的所有上級(jí)父部門(mén)路徑查詢(xún)指定用戶(hù)的所有上級(jí)父部門(mén)路徑。支持支持不支持部門(mén)管理（2.0）創(chuàng)建部門(mén)創(chuàng)建新部門(mén)。支持不支持不支持更新部門(mén)更新部門(mén)信息。支持不支持不支持刪除部門(mén)根據(jù)部門(mén)ID刪除指定部門(mén)。支持不支持不支持獲取部門(mén)詳情根據(jù)部門(mén)ID獲取指定部門(mén)詳情。支持支持不支持獲取子部門(mén)ID列表獲取企業(yè)部門(mén)下的所有直屬子部門(mén)列表。支持支持不支持獲取指定用戶(hù)的所有父部門(mén)列查詢(xún)指定用戶(hù)所屬的所有父級(jí)部門(mén)。支持支持不支持獲取指定部門(mén)的所有父部門(mén)列表獲取指定部門(mén)的所部門(mén)列表。支持支持不支持獲取部門(mén)列表獲取部門(mén)列表。支持支持不支持角色管理獲取角色組列表獲取角色組信息。支持支持不支持獲取角色列表獲取角色列表。支持支持不支持獲取角色詳情根據(jù)角色I(xiàn)D獲取指定角色詳情。支持支持不支持獲取指定角色的員工列表獲取指定角色的員工列表。支持支持不支持創(chuàng)建角色創(chuàng)建新角色。支持不支持不支持創(chuàng)建角色組創(chuàng)建角色組。支持不支持不支持更新角色更新角色名稱(chēng)。支持不支持不支持批量增加員工角色批量增加員工角色。支持不支持不支持刪除角色刪除指定的角色。支持不支持不支持批量刪除員工角色批量刪除員工的角色。支持不支持不支持設(shè)定角色成員管理范圍設(shè)定角色成員管理范圍。支持不支持不支持外部聯(lián)系人獲取外部聯(lián)系人列表獲取企業(yè)外部聯(lián)系人列表。支持支持不支持獲取外部聯(lián)系人標(biāo)簽列表獲取企業(yè)外部聯(lián)系人的標(biāo)簽。支持支持不支持獲取外部聯(lián)系人詳情獲取企業(yè)外部聯(lián)系人的詳細(xì)信息。支持支持不支持添加外部聯(lián)系人添加企業(yè)外部聯(lián)系人。支持不支持不支持97>服務(wù)端API刪除外部聯(lián)系人刪除企業(yè)外部聯(lián)系人支持不支持不支持更新外部聯(lián)系人更新企業(yè)外部聯(lián)系人。支持不支持不支持行業(yè)通訊錄獲取部門(mén)詳情根據(jù)部門(mén)ID獲取部門(mén)詳情。支持支持不支持獲取部門(mén)下人員列表獲取部門(mén)下的人員列表信息。支持支持不支持獲取部門(mén)列表根據(jù)部門(mén)ID獲取部門(mén)列表。支持支持不支持獲取部門(mén)用戶(hù)詳情獲取部門(mén)用戶(hù)詳情。支持支持不支持獲取企業(yè)信息獲取行業(yè)通訊錄的企業(yè)信息。支持支持不支持類(lèi)目API說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用合作空間獲取加入或申請(qǐng)加入合作空間的組織和個(gè)人信息獲取加入或申請(qǐng)加入合作空間的組織和個(gè)人信息。支持支持不支持獲取企業(yè)已經(jīng)加入或申請(qǐng)加入的合作空間的信獲取企業(yè)已經(jīng)加入或申請(qǐng)加入的合作空間的信息。支持支持不支持關(guān)聯(lián)組織獲取主干組織列表獲取主干組織列表。支持支持不支持獲取分支組織列表獲取分支組織列表。支持支持不支持服務(wù)端API<98類(lèi)目API說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用工作通知使用模板發(fā)送工作通知消息使用消息模板發(fā)送工作通知。不支持支持不支持發(fā)送工作通知發(fā)送工作通知消息。支持支持不支持更新工作通知狀態(tài)欄更新OA工作通知消息的狀態(tài)。支持支持不支持獲取工作通知消息的發(fā)送進(jìn)度獲取工作通知消息的發(fā)送進(jìn)度。支持支持不支持獲取工作通知消息的發(fā)送結(jié)果查詢(xún)工作通知消息的發(fā)送結(jié)果。支持支持不支持撤回工作通知消息撤回工作消息通知。支持支持不支持企業(yè)群消息發(fā)送消息到企業(yè)群發(fā)送消息到企業(yè)群。支持不支持不支持查詢(xún)?nèi)合⒁炎x人員列表查詢(xún)?nèi)合⒁炎x人員列表。支持不支持不支持群消息創(chuàng)建群會(huì)話(huà)創(chuàng)建群會(huì)話(huà)。支持不支持不支持獲取群會(huì)話(huà)信息獲取群設(shè)置和成員信息。支持不支持不支持修改群會(huì)話(huà)修改群會(huì)話(huà)。支持不支持不支持設(shè)置群管理員設(shè)置群管理員。支持不支持不支持設(shè)置禁止群成員私聊設(shè)置群成員之間是否可以添加好友和私聊。支持不支持不支持99>服務(wù)端API獲取入群二維碼鏈接獲取群入群二維碼邀請(qǐng)鏈接。支持不支持不支持設(shè)置群成員昵稱(chēng)設(shè)置群成員在群中的昵稱(chēng)。支持不支持不支持普通消息發(fā)送普通消息發(fā)送普通消息。支持支持不支持類(lèi)目API說(shuō)明企業(yè)內(nèi)部應(yīng)用第三方企業(yè)應(yīng)用第三方個(gè)人應(yīng)用官方工作流創(chuàng)建或更新審批模板創(chuàng)建或更新審批模板。不支持支持不支持發(fā)起審批實(shí)例發(fā)起一個(gè)審批。支持支持不支持終止審批流程終止當(dāng)前企業(yè)下發(fā)起的審批實(shí)例。支持不支持不支持下載審批附件審批文件下載授權(quán)，并且生成下載鏈接。支持不支持不支持獲取審批實(shí)例ID列表獲取權(quán)限范圍內(nèi)的相關(guān)部門(mén)審批實(shí)例ID列表。