dingtalk_suite
v1.1.7
Published
钉钉套件主动调用api
Downloads
6
Readme
dingtalk suite
钉钉套件主动调用API, 自带cache。
回调server API见:dingtalk_suite_callback
配和企业号 API:dingtalk_enterprise可实现ISV套件控制企业号。
##安装
npm install dingtalk_suite
##示例
构造函数:
var dd_talk = require('dingtalk_suite');
var conf = {
suiteid: 'suitexpiygdnxxxxx',
secret: 'C1oXyeJUgH_QXEHYJS4-Um-zxfxxxxxxxxxxxxxxxxxx-6np3fXskv5dGs',
getTicket: function(callback){
//从数据库中取出Tikcet,返回的data样式为:{value: 'xxxxxxx', expires:1452735301543}
//ticket从 dingtalk_suite_callback 处获得
fs.readFile(this.suiteid + 'ticket.txt',function(err, data){
if(err){
return callback(err);
}
data = JSON.parse(data.toString());
callback(null, data);
});
},
getToken: function(callback){
//从数据库中取出Token,返回的data样式为:{value: 'xxxxxxx', expires:1452735301543}
fs.readFile(this.suiteid + 'token.txt',function(err, data){
if(err){
return callback(err);
}
data = JSON.parse(data.toString());
callback(null, data);
});
},
saveToken: function(data, callback){
//存储Token到数据库中,data样式为:{value: 'xxxxxxx', expires:1452735301543//过期时间}
fs.writeFile(this.suiteid + 'token.txt',JSON.stringify(data), callback);
}
}
var api = new dd_talk(conf);
注:本项目自带cache, token的过期时间默认为1小时59分50秒(防止网络延迟,故比规定2小时少了10秒)。
可以在conf.token_expires_in
更改(不可大于2小时)。
##方法
获取企业号永久授权码
api.getPermanentCode(tmp_auth_code, callback)
tmp_auth_code字符串,由dingtalk_suite_callback处获得。
获取企业号Token
//auth_corpid和permanent_code由上面接口获得。
api.getCorpToken(auth_corpid, permanent_code, callback)
获取企业号信息
api.getAuthInfo(auth_corpid, permanent_code, callback)
获取企业号应用
api.getAgent(agentid, auth_corpid, permanent_code, callback)
激活授权套件
api.activateSuite(auth_corpid, permanent_code, callback)
为授权方的企业单独设置IP白名单
//ip_whitelist为数组格式:["1.2.3.4","5.6.*.*"]
api.setCorpIpwhitelist(auth_corpid, ip_whitelist, callback)
##更多钉钉相关 ISV套件回调server: dingtalk_suite_callback 企业号API: dingtalk_enterprise ISV和企业号免登API: dingtalk_sso