釘釘微應用的 Access token 如何獲取?
Access_Token 是企業訪問釘釘開放平台全局接口的唯一憑證,即調用接口時需攜帶Access_Token。從接口列表看,所有接口都需要攜帶 access token。
對於企業接入來說,AccessToken 需要用 CorpID 和 CorpSecret 來換取,CorpID 是企業在釘釘中的標識;每個企業擁有一個唯一的 CorpID,CorpSecret 是企業每個微應用的憑證密鑰。
CorpID和CorpSecret可以在開發者后台中找到。
不同的 CorpSecret 會返回不同的 AccessToken。
正常情況下AccessToken有效期為7200秒,有效期內重復獲取返回相同結果,並自動續期。
請求方式:GET
接口地址:https://oapi.dingtalk.com/gettoken?corpid=id&corpsecret=secrect
返回示例
{ "errcode": 0, "errmsg": "ok", "access_token": "fw8ef8we8f76e6f7s8df8s" }
Laravel Cache 對 access token 進行緩存
https://laravel.com/docs/5.5/cache
Laravel 默認是使用文件 file 進行緩存存儲的,當然,也可以替換為 mysql, redis 的存儲方案。
但是當對性能要求不高的情況下,使用文件存儲緩存足矣。
- 省去了對數據庫的依賴,方便運維和部署
- 另外也避免了小內存服務器內存不足的尷尬情況
cache 的基本使用
$value = cache('key'); // 獲取 key 對應的值
Cache 設置緩存的第二個參數支持兩種類型
- 整數。代表N分鍾后失效
- datetime。代表到哪個時間點失效
cache(['key' => 'value'], $minutes); cache(['key' => 'value'], now()->addSeconds(10)); cache(['key' => 'value'], now()->addMinutes(10));
示例代碼
/** * 獲取 Access Token * * 如果 access token 不存在,或者失效,重新獲取。 * 若未失效,繼續使用 cache 中的 token. */ public function get_access_token() { // 先判斷 cache 中是否存在 $key = 'dingding_access_token'; $access_token = cache($key); if ($access_token) { return $access_token; } Log::info('No access token in cache. Getting...'); $client = new Client(); $url = sprintf( "https://oapi.dingtalk.com/gettoken?corpid=%s&corpsecret=%s", env("CORP_ID"), env("CORP_SECRET")); $res = $client->request('GET', $url, ['timeout' => 1.5]); $res = $res->getBody(); $res = json_decode($res); if ($res->errcode == 0) { cache([$key => $res->access_token], now()->addSeconds(7000)); return $res->access_token; } else { abort(403, 'Fail to get dingding access token.'); } }
使用 mysql 作為 cache 緩存的存儲方案
如果希望修改 cache 的存儲方案為 mysql,可以進行如下操作。
修改 .env 配置
將
CACHE_DRIVER=file
替換為
CACHE_DRIVER=database
新建對應得 mysql cache 表
php artisan cache:table php artisan migrate // 對應生成的數據表 CREATE TABLE `cache` ( `key` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL, `value` mediumtext COLLATE utf8mb4_unicode_ci NOT NULL, `expiration` int(11) NOT NULL, UNIQUE KEY `cache_key_unique` (`key`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
之所以沒有使用 mysql 或者 redis 存儲 cache,是因為我看到表中產生了其他緩存數據,總之緩存的數量看上去不可控。服務器的內存太小,暫時不想冒這個風險。