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

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