釘釘企業(yè)內(nèi)部H5微應(yīng)用開發(fā)詳解

企業(yè)內(nèi)部H5微應(yīng)用開發(fā) 分為 服務(wù)端API和前端API的開發(fā),主要涉及到進(jìn)入應(yīng)用免登流程和JSAPI鑒權(quán)。
JSAPI鑒權(quán)開發(fā)步驟:
1、創(chuàng)建H5微應(yīng)用
登入釘釘開放平臺(tái)(https://open-dev.dingtalk.com/),進(jìn)入“應(yīng)用開發(fā)”->企業(yè)內(nèi)部開發(fā)H5微應(yīng)用->創(chuàng)建應(yīng)用,并填寫基本信息和配置開發(fā)信息
2、JSAPI鑒權(quán)服務(wù)端API的開發(fā):
(1)通過appKey 和 appSecret 獲取調(diào)用接口憑證AccessToken(https://oapi.dingtalk.com/gettoken?appkey=appKey&appsecret=appSecret)
(2)通過AccessToken 獲取用于JSAPI的臨時(shí)票據(jù)Ticket(https://oapi.dingtalk.com/get_jsapi_ticket?access_token=ACCESS_TOKEN)
(3)ticket(JSAPI的臨時(shí)票據(jù)),nonceStr(隨機(jī)串),timeStamp(時(shí)間戳),url(當(dāng)前網(wǎng)頁(yè)的URL,不包含#及其后面部分)計(jì)算簽名信息
計(jì)算簽名參數(shù)
/* *ticket(JSAPI的臨時(shí)票據(jù)),nonceStr(隨機(jī)串),timeStamp(時(shí)間戳),url(當(dāng)前網(wǎng)頁(yè)的URL,不包含#及其后面部分)計(jì)算簽名信息 * */ public static function sign($ticket, $nonceStr, $timeStamp, $url) { $plain = 'jsapi_ticket=' . $ticket . '&noncestr=' . $nonceStr . '×tamp=' . $timeStamp . '&url=' . $url; return sha1($plain); }
(4)通過AccessToken 獲取用于JSAPI的臨時(shí)票據(jù)Ticket(說明:由于會(huì)牽涉到多個(gè)企業(yè),企業(yè)的appKey 和 appSecret的一些信息都是寫在JSON配置文件中,前端傳企業(yè)ID到服務(wù)端,服務(wù)端就會(huì)從JSON配置文件中獲取企業(yè)信息)
/* * 根據(jù)企業(yè)ID corpid 返回 JSAPI 鑒權(quán)配置信息 * */ public static function getConfig($corpid) { $_config = self::getApiConfig($corpid); $appkey = $_config["AppKey"]; $appsecret = $_config["AppSecret"]; $agentid = $_config["AgentId"]; $nonceStr = 'flywong'; $timeStamp = time(); //$url = self::getCurrentUrl(); $url = $_config["AppUrl"]; $accessToken = self::getAccessToken($appkey,$appsecret); $ticket = self::getTicket($accessToken); $signature = self::sign($ticket, $nonceStr, $timeStamp, $url); $config = array( 'agentId' => $agentid, 'corpId' => $corpid, 'timeStamp' => $timeStamp, 'nonceStr' => $nonceStr, 'signature' => $signature, 'url' => $url, 'type'=>0 ); return json_encode($config, JSON_UNESCAPED_SLASHES); }
/* * 根據(jù)企業(yè)ID corpid 從api_config.json配置文件中找到 企業(yè)對(duì)應(yīng)的信息,并返回企業(yè)應(yīng)用開發(fā)信息 * */ public static function getApiConfig($corpid) { $json_string = file_get_contents(__DIR__ .'/../api_config.json'); //從文件中讀取數(shù)據(jù)到PHP變量 $arrs = json_decode($json_string, true); foreach($arrs as $key => $value) { if($value["CorpId"] == $corpid) { return $value; } } }
企業(yè)的配置文件api_config.json
3、JSAPI鑒權(quán)前端API的開發(fā):
前端發(fā)送GET請(qǐng)求獲取服務(wù)端的JSAPI 鑒權(quán)配置信息
// 異步獲取dd.config async getDDConfig({commit, state},callback) { // 發(fā)送異步ajax請(qǐng)求 const result = await reqDDConfig(state.CorpId) // 提交一個(gè)mutation const ddconfig = result ddconfig.jsApiList= state.jsApiList dd.config(ddconfig); commit(RECEIVE_DDCONFIG, {ddconfig}) // 數(shù)據(jù)更新了, 通知一下組件 callback && callback() }
let that = this; //獲取 JSAPI 鑒權(quán)配置信息 that.$store.dispatch('getDDConfig', () => {// that.$nextTick(() => {// 數(shù)據(jù)ddconfig state 更新后執(zhí)行 that.$store.dispatch('getUserinfo')//獲取登入用戶信息 that.$store.dispatch('getGeolocation')//獲取地圖定位信息 }) })
/* 狀態(tài)管理*/ export default { CorpId:'dingb0bd5c5a3ba53e1231232378f',//企業(yè)ID ddconfig:{},//釘釘簽權(quán)配置信息 jsApiList:[ 'runtime.info', 'biz.contact.choose', 'device.notification.confirm', 'device.notification.alert', 'device.notification.prompt', 'biz.ding.post', 'biz.util.openLink', 'device.geolocation.get', 'biz.util.scanCard' ],//需要簽權(quán)的JSAPI userinfo:{}, //用戶信息 geolocation:{} //地圖定位信息 }
4、H5微應(yīng)用的免登
“免登”是指用戶進(jìn)入應(yīng)用后,無需輸入釘釘用戶名和密碼,應(yīng)用程序可自動(dòng)獲取當(dāng)前用戶身份,進(jìn)而登錄系統(tǒng)的流程。
1、前端去獲取微應(yīng)用免登授權(quán)碼,然后把授權(quán)碼發(fā)送到服務(wù)端api得到當(dāng)前用戶信息
// 異步獲取userinfo getUserinfo({commit, state}) { dd.runtime.permission.requestAuthCode({ corpId: state.CorpId, // 企業(yè)id onSuccess: async function (info) { let code = info.code // 通過該免登授權(quán)碼可以獲取用戶身份 // 發(fā)送異步ajax請(qǐng)求 const result = await reqUserinfo(code,state.CorpId) // 提交一個(gè)mutation const userinfo = result commit(RECEIVE_USERINFO, {userinfo}) } }) }
2、服務(wù)端API獲取用戶信息
/* * 通過免登授權(quán)碼code和access_token獲取用戶的userid * */ public static function getUserInfo($accessToken, $code) { $response = \util\Http::get("/user/getuserinfo",array("access_token" => $accessToken, "code" => $code)); $userinfo = json_decode(json_encode($response),true); $userid = $userinfo["userid"]; return self::getuser($accessToken,$userid); } /* * 通過access_token 和 userid 獲取用戶詳情 * */ private static function getuser($accessToken,$userid) { $response = \util\Http::get("/user/get",array("access_token" => $accessToken, "userid" => $userid)); return json_encode($response); }
提醒:釘釘?shù)男畔@取必須在釘釘應(yīng)用環(huán)境中運(yùn)行。(我是在電腦上安裝安卓模擬器然后安裝釘釘APP進(jìn)行調(diào)試的)
到此這篇關(guān)于釘釘企業(yè)內(nèi)部H5微應(yīng)用開發(fā)詳解的文章就介紹到這了,更多相關(guān)釘釘企業(yè)內(nèi)部H5微應(yīng)用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章
- Microdata作為HTML5新增的一個(gè)特性,它允許開發(fā)者在HTML文檔中添加更多的語義信息,以便于搜索引擎和瀏覽器更好地理解頁(yè)面內(nèi)容,本文將探討HTML5中Microdata的使用方法以及2025-04-21
- 在HTML語法中,表格主要通過< table >、< tr >和< td >3個(gè)標(biāo)簽構(gòu)成,本文通過實(shí)例代碼講解HTML5表格語法格式,感興趣的朋友一起看看吧2025-04-21
- 這篇文章主要介紹了HTML5中使用媒體查詢和Flexbox進(jìn)行響應(yīng)式布局的方法,簡(jiǎn)要介紹了CSS Grid布局的基礎(chǔ)知識(shí)和如何實(shí)現(xiàn)自動(dòng)換行的網(wǎng)格布局,感興趣的朋友一起看看吧2025-04-21
基于Canvas的Html5多時(shí)區(qū)動(dòng)態(tài)時(shí)鐘實(shí)戰(zhàn)代碼
本文介紹了如何使用Canvas在HTML5上實(shí)現(xiàn)一個(gè)多時(shí)區(qū)動(dòng)態(tài)時(shí)鐘的web展示,通過Canvas的API,可以繪制出6個(gè)不同城市的時(shí)鐘,并且這些時(shí)鐘可以動(dòng)態(tài)轉(zhuǎn)動(dòng),每個(gè)時(shí)鐘上都會(huì)標(biāo)注出對(duì)應(yīng)的2025-03-11HTML5 data-*自定義數(shù)據(jù)屬性的示例代碼
HTML5的自定義數(shù)據(jù)屬性(data-*)提供了一種標(biāo)準(zhǔn)化的方法在HTML元素上存儲(chǔ)額外信息,可以通過JavaScript訪問、修改和在CSS中使用,文章還介紹了高級(jí)用法,如存儲(chǔ)JSON數(shù)據(jù)、事2025-03-11HTML5中下拉框<select>標(biāo)簽的屬性和樣式詳解
在HTML5中,下拉框(<select>標(biāo)簽)作為表單的重要組成部分,為用戶提供了一個(gè)從預(yù)定義選項(xiàng)中選擇值的方式,本文將深入探討<select>標(biāo)簽的屬性、樣式,并重點(diǎn)介2025-02-27- 本文介紹了HTML5InputDatePicker對(duì)象表示HTML``元素,是HTML5中的新對(duì)象,介紹了日期、周、月份、時(shí)間、日期+時(shí)間、本地日期時(shí)間等不同類型的日期選擇器,感興趣的朋友一起看2025-02-17
- 本文介紹了HTML5中的超鏈接、相對(duì)路徑和圖片的使用方法,超鏈接可以創(chuàng)建指向另一個(gè)文檔或頁(yè)面內(nèi)部書簽的鏈接,相對(duì)路徑用于在同一服務(wù)器內(nèi)部跳轉(zhuǎn)頁(yè)面,圖片標(biāo)簽用于引入外部圖2025-02-17
- 本文介紹了HTML5超鏈接的創(chuàng)建方法,包括基本語法、創(chuàng)建圖像超鏈接的邊框去除方法以及錨點(diǎn)鏈接的使用,還討論了超鏈接的四種不同狀態(tài)(link、visited、hover、active)的CSS樣2025-02-17
HTML5使用details標(biāo)簽:展開/收縮信息
最近看一些技術(shù)網(wǎng)站發(fā)現(xiàn)了details 標(biāo)簽的妙用,這個(gè)不用js即可實(shí)現(xiàn)展開/收縮信息,很方便用來讓用戶先才答案,然后下面點(diǎn)擊再給出答案的效果,這里就為大家簡(jiǎn)單介紹一下,2024-11-03