企業(yè)內部H5微應用開發(fā) 分為 服務端API和前端API的開發(fā)，主要涉及到進入應用免登流程和JSAPI鑒權。
JSAPI鑒權開發(fā)步驟：
1、創(chuàng)建H5微應用
登入釘釘開放平臺（https://open-dev.dingtalk.com/）,進入“應用開發(fā)”->企業(yè)內部開發(fā)H5微應用->創(chuàng)建應用,并填寫基本信息和配置開發(fā)信息
2、JSAPI鑒權服務端API的開發(fā)：
(1)通過appKey 和 appSecret 獲取調用接口憑證AccessToken(https://oapi.dingtalk.com/gettoken?appkey=appKey&appsecret=appSecret)
(2)通過AccessToken 獲取用于JSAPI的臨時票據(jù)Ticket(https://oapi.dingtalk.com/get_jsapi_ticket?access_token=ACCESS_TOKEN)
(3)ticket(JSAPI的臨時票據(jù))，nonceStr(隨機串),timeStamp(時間戳)，url(當前網(wǎng)頁的URL，不包含#及其后面部分)計算簽名信息
計算簽名參數(shù)
/*
*ticket(JSAPI的臨時票據(jù))，nonceStr(隨機串),timeStamp(時間戳)，url(當前網(wǎng)頁的URL，不包含#及其后面部分)計算簽名信息
* */
public static function sign($ticket, $nonceStr, $timeStamp, $url)
{
$plain = 'jsapi_ticket=' . $ticket .
'&noncestr=' . $nonceStr .
'×tamp=' . $timeStamp .
'&url=' . $url;
return sha1($plain);
}
(4)通過AccessToken 獲取用于JSAPI的臨時票據(jù)Ticket(說明：由于會牽涉到多個企業(yè)，企業(yè)的appKey 和 appSecret的一些信息都是寫在JSON配置文件中，前端傳企業(yè)ID到服務端，服務端就會從JSON配置文件中獲取企業(yè)信息)
/*
* 根據(jù)企業(yè)ID corpid 返回 JSAPI 鑒權配置信息
* */
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è)對應的信息，并返回企業(yè)應用開發(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鑒權前端API的開發(fā)：
前端發(fā)送GET請求獲取服務端的JSAPI 鑒權配置信息
// 異步獲取dd.config
async getDDConfig({commit, state},callback) {
// 發(fā)送異步ajax請求
const result = await reqDDConfig(state.CorpId)
// 提交一個mutation
const ddconfig = result
ddconfig.jsApiList= state.jsApiList
dd.config(ddconfig);
commit(RECEIVE_DDCONFIG, {ddconfig})
// 數(shù)據(jù)更新了, 通知一下組件
callback && callback()
}
let that = this;
//獲取 JSAPI 鑒權配置信息
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:{},//釘釘簽權配置信息
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'
],//需要簽權的JSAPI
userinfo:{}, //用戶信息
geolocation:{} //地圖定位信息
}
4、H5微應用的免登
“免登”是指用戶進入應用后，無需輸入釘釘用戶名和密碼，應用程序可自動獲取當前用戶身份，進而登錄系統(tǒng)的流程。
1、前端去獲取微應用免登授權碼，然后把授權碼發(fā)送到服務端api得到當前用戶信息
// 異步獲取userinfo
getUserinfo({commit, state}) {
dd.runtime.permission.requestAuthCode({
corpId: state.CorpId, // 企業(yè)id
onSuccess: async function (info) {
let code = info.code // 通過該免登授權碼可以獲取用戶身份
// 發(fā)送異步ajax請求
const result = await reqUserinfo(code,state.CorpId)
// 提交一個mutation
const userinfo = result
commit(RECEIVE_USERINFO, {userinfo})
}
})
}
2、服務端API獲取用戶信息
/*
* 通過免登授權碼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ù)男畔@取必須在釘釘應用環(huán)境中運行。（我是在電腦上安裝安卓模擬器然后安裝釘釘APP進行調試的）
到此這篇關于釘釘企業(yè)內部H5微應用開發(fā)詳解的文章就介紹到這了,更多相關釘釘企業(yè)內部H5微應用內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！
