Download the PHP package thefunpower/dingding without Composer

钉钉

安装

composer require thefunpower/dingding

开发版

"thefunpower/dingding": "dev-main"

时区

date_default_timezone_set('PRC');
set_time_limit(-1); 

常见用法

初始化

get_ding_token($dd_app_key,$dd_app_secret); 

获取用户列表

$res = get_ding_users();
print_r($res); 

部门列表

get_ding_depts($is_tree = false,$is_user = false);

$is_tree 是否树型显示

$is_user 是否显示部门下员工信息

取某个部门下的员工

get_ding_dept_users($dept_id)

创建部门

ding_create_dept('演示部门创建'); 

更新部门

ding_update_dept('演示部门创建','新名称');

根据部门名称取部门ID

get_ding_dept_id_by_name($name)

创建员工

https://open.dingtalk.com/document/orgapp/user-information-creation

$res = ding_create_user([
  'name'=>'姓名',
  'mobile'=>'手机号',
  'dept_name'=>'部门名称，如果没有先创建',
  //'title'=>'',//职位，长度最大为200个字符。
  //'email'=>'',//员工邮箱是唯一的，企业内不能重复。 
  //'hired_date'=>'',//入职时间，Unix时间戳，单位毫秒。
]);

更新员工

$res = ding_update_user('员工手机号或邮件',[
  'name'=>'姓名', 
  //'dept_name'=>'新名称',
  //'title'=>'',//职位，长度最大为200个字符。
  //'email'=>'',//员工邮箱是唯一的，企业内不能重复。 
  //'hired_date'=>'',//入职时间，Unix时间戳，单位毫秒。
]);

获取员工userid

$res = get_ding_user_id("员工手机号或邮件");

考勤

限制7天，格式 YYYY-MM-DD hh:ii:ss

https://open.dingtalk.com/document/isvapp/attendance-clock-in-record-is-open

get_ding_kq($opt = [
  'start' => '',
  'end'   => '',
]);

发送消息

$title = "test";
$text  = "这个是内容";
send_ding_notice_text($robot_code='ding0uednrlb3kyef0xb',$user_id = ['0246365867749182'], $title, $text);

markdown消息 $text 值如下所示

# 这是支持markdown的文本   \n   ## 标题2    \n   * 列表1   \n  ![alt 啊](https://img.alicdn.com/tps/TB1XLjqNVXXXXc4XVXXXXXXXXXX-170-64.png)

markdown语法说明如下

标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

引用
> A man who stands for nothing will fall for anything.

文字加粗、斜体
**bold**
*italic*

链接
[this is a link](http://name.com)

图片
![](http://name.com/pic.jpg)

无序列表
- item1
- item2

有序列表
1. item1
2. item2

换行
  \n  (建议\n前后分别加2个空格)

原生发消息

$msg_param 参数请参考 https://open.dingtalk.com/document/orgapp/message-types-and-data-format

send_ding_notice($robot_code,$user_id = [], $msg_param = [],$msg_key = 'sampleMarkdown')

创建钉钉应用

访问钉钉

创建H5微应用

在【应用信息】中找到 【AppKey】 【AppSecret】

在【机器人与消息推送】 复制 RobotCode

获取接口调用错误

echo get_ding_error();

类调用方法

一般不用看这里

1.配置不同的分组信息

$dd_app_key = '';
$dd_app_secret = '';

DingDingHelper::set('default',$dd_app_key,$dd_app_secret);

$dd_app_key = '';
$dd_app_secret = '';

DingDingHelper::set('test',$dd_app_key,$dd_app_secret);

2.调用分组信息

$res = DingDingHelper::get('default')->get_ding_dept_id_by_name('部门名称'); 
$res = DingDingHelper::get('test')->get_ding_dept_id_by_name('部门名称');

2-1.类继承方式调用

class A extends DingDingClass{
  protected $group_name = 'default'; 

}

class B extends DingDingClass{
  protected $group_name = 'test';  
}

调用分组信息

$a = new A;
$b = new B; 
$a->get_ding_dept_id_by_name('部门名称');
$b->get_ding_dept_id_by_name('部门名称');
$a->get_ding_dept_id_by_name('部门名称');

开源协议

Apache License 2.0