mingyoung / dingtalk

[已停止维护]

EasyDingTalk

介绍

EasyDingTalk 封装了钉钉身份验证、通讯录管理、消息通知、审批、群机器人、业务事件回调管理等服务端接口，让开发者可以使用简单的配置，提供简洁的 API 以供方便快速地调用钉钉接口。

环境要求

• PHP 7.0+
• Composer

安装

composer require mingyoung/dingtalk:^2.0

使用

use EasyDingTalk\Application;

$config = [
    'corp_id' => 'dingd3ir8195906jfo93',

    'app_key' => 'dingwu33fo1fjc0fszad',
    'app_secret' => 'RsuMFgEIY3jg5UMidkvwpzEobWjf9Fcu3oLqLyCUIgzULm54WcV7j9fi3fJlUshk',
];

$app = new Application($config);

文档

https://docs.easydingtalk.org

License

MIT

dingtalk's Issues

postJson方法没有

https://docs.easydingtalk.org/start.html#%E5%AE%89%E8%A3%85
文档里面写的安装方法是composer require mingyoung/dingtalk:^2.0。
2.0版本的overtrue/http包写的是 ^1.1.2，会导致安装最新的1.X版本overtrue/http包。里面没有postJosn方法了
建议文档更新一下呢

不支持普通消息吗

不支持普通消息吗，只支持群消息？

需要**正确**使用 composer 安装

需要正确使用 composer 安装

https://getcomposer.org/doc/

Originally posted by @mingyoung in #37 (comment)

响应钉钉服务器 {"errcode":71009,"errmsg":"返回文本非success"}

{
$app = init_ding();
$server = $app->server;
$server->push(function ($payload) {
// 此处 $payload 为钉钉推送事件解密后的内容，为数组形式
/**
* 比如测试回调 URL 事件，$payload 内容为：
*
* $payload = [
* "EventType" => "check_url",
* ]
*/
$type = $payload['EventType'];
// ...
// 可根据内容处理你对应的业务逻辑
});
$server->serve()->send(); // ThinkPHP 等框架使用
}
方法代码如上，用自定义类也是返回文本非success。
是我哪儿出错了吗？

日志填写功能

希望作者增加日志填写的sdk

easy钉钉 应用管理下的四个接口无法使用！

如题 请问是因为钉钉关掉了这几个接口吗？还是什么原因？

根据手机号获取用户信息接口参数名错误

代码文件路径：vendor\mingyoung\dingtalk\src\User\Client.php

代码块：

 /**
     * 根据员工手机号获取 Userid
     *
     * @param string $phone
     *
     * @return mixed
     */
    public function getUserIdByPhone($phone = '')
    {
        return $this->client->get('user/get_by_mobile', compact('phone'));
    }

这里的 phone 参数名官方实际为 mobile ，使用 phone 参数名接口报错

---

官方接口说明

请求方式：GET（HTTPS）

请求地址：https://oapi.dingtalk.com/user/get_by_mobile?access_token=ACCESS_TOKEN&mobile=1xxxxxxxxxx

名称	类型	是否必须	说明
access_token	String	必须	调用接口凭证，通过获取企业access_token获取
mobile	String	必须	手机号码

参考资料-钉钉官方手册

Class 'Symfony\Component\Cache\Simple\FilesystemCache' not found

您好,symfony/cache 5.0中不再包含Symfony\Component\Cache\Simple\FilesystemCache,运行时将产生错误.

关于 Travis CI 配置的问题

您好，我提交了一个 Pull #48 修改内容仅仅为增加注释，尝试了两次 Travis CI 始终报错，对比了一下这两次的 Job log 和 5个月前最后一次成功的 Job log，发现是有差异的。不过我不太熟悉 Travis CI，也无法明显看出错误原因，还望协助处理。

请问“审批”功能在哪里？

请问“审批”功能在哪里？

composer 上 没有 process 审批的相关代码

composer require mingyoung/dingtalk:^2.0

$app->department->list无法获取子部门的信息

尝试官方sdk返回的信息中包含子部门的信息，但是这个没有

您好，请问消息通知以及机器人会集成到SDK里面吗？

所有的接口接入与验证，我已经做完了，这个SDK非常不错封装思路很清晰；另外 审核 最近钉钉的开发团队已经更新了部分接口；消息通知和机器人您有意封装到本SDK里面吗？如果没有我打算自己做这个轮子。期待你的回复

获取部门详情接口返回字段问题

获取部门详情接口返回的字段中是否是多了一个userPerimits字段？

是否没有返回sourceIdentifier字段，返回中的deptGroupChatId字段是什么意思，好像官方文档中并没有对应的字段？

果然是一个嗟来之食

我先尝一口

钉钉扫码登陆第三方页面

$app = new Application($this->config);
$response = $app->oauth->use('app-01')->withQrConnect()->redirect();
直接会报上面的错误

钉钉扫码第三方登陆获取用户信息报签名时间戳超时

$app->oauth->use('app-01')->user();

钉钉界面展示问题

在不定的时间里，钉钉的聊天框界面会模糊，请问下是什么原因呢，最近版本，mac pro

发送工作消息有bug

/** * 发送工作通知消息 * * @param array $params * * @return mixed */ public function sendCorporationMessage($params) { return $this->client->post('topapi/message/corpconversation/asyncsend_v2', $params); }
应该更改为
/** * 发送工作通知消息 * * @param array $params * * @return mixed */ public function sendCorporationMessage($params) { return $this->client->postJson('topapi/message/corpconversation/asyncsend_v2', $params); }

跳转方式第三方登录钉钉

我发现只能用
$response = $this->dingTalk->oauth->use('app-01')->withQrConnect()->redirect(); return $response;
该方法生成的页面才能正常使用下去，点击超链接后还会闪一下才会进入到扫码页面！
我想使用里面的$response->getTargetUrl()得到的链接作为超链接，会报错！

2.0咨询

我看到2.0已有部分文档https://docs.easydingtalk.org/2.0/

不知道新项目什么地步了？是写文档阶段还是sdk没写完？

新项目可以直接用2.0开发不？

GetToken API

Hi,

Does this library implement https://oapi.dingtalk.com/gettoken API?
I went through the code in Auth but couldn't find implementation of the above API.

Reference:
https://docs.alipay.com/DingTalkdoc_en/sq9tkr/mht2g1#a-name%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96access_tokenahow-to-obtain-access_token

工作消息通知，总是提示{"errcode":40,"errmsg":"Missing required arguments:msg","request_id":"sq35gefm5b55"}

public function jobMsg(Request $request) { $params = $request->post(); $mcy_ding = new McyDing($this->_config); // $access_token = $mcy_ding->access_token->get(); $data = [ "agent_id"=> "626044106", "userid_list"=>$params['ding_userid'], "msg" =>[ "msgtype"=>'markdown', "markdown"=>[ "title"=>$params['title'].'接机工作任务', "text"=>$params['text'] ] ] ]; $result = $mcy_ding->conversation->sendCorporationMessage($data); return $result; }
已经传msg了，总是提示Missing required arguments:msg

钉钉更新

你好，钉钉官方已经更新说明，不再支持corpsecret获取，但已申请过的corpsecret仍可使用，将改为appkey和appsecret获取token，Kernel/Credential.php中的credentials方法建议调整一下，增加一个判断

支持symfony 5.0

您好,symfony 5.0相关依赖已经发布了,麻烦调整下依赖限制,以便支持升级

EasyDingTalk有发送工作通知的方法吗？

EasyDingTalk有发送工作通知的方法吗？

不能发送消息和通知吗？

希望更新一下

access_token的缓存是不是有问题？

PHP Fatal error: Allowed memory size of 268435456 bytes exhausted (tried to allocate 20480 bytes) in \dingtalk\vendor\guzzlehttp\psr7\src\MessageTrait.php on line 158
缓存是不是有问题？
access_token过期后再次请求一直都是报错的

可不可以增加一个日志的接口

因项目开发需要拉取钉钉用户提交的日志数据记录；我测试了一下您的包，只需要调用httpGetMethod()就可以拉取到日志数据，不知道您这边能不能把这个功能集成到这个包扩展里？

可不可以增加个事件回调功能

看了一下 好像没有这个功能
文档地址： https://open-doc.dingtalk.com/microapp/serverapi2/pwz3r5
这个功能可以方便监听一些事件的推送

增加了管理钉盘文件的接口希望早日更新

还有一些是有功能了，但是没有文档，比如，上传文件

请问不支持消息通知么？

关于第三方企业应用的接入

请问您会把第三方企业应用相关的接口封装进来本SDK吗？

我直接composer require mingyoung/dingtalk下来使用时少了一个文件

Interface 'Psr\SimpleCache\CacheInterface' not found 报错

第三方登录(扫码登录)如何自定义state值

请问如何新建日历？"Invalid arguments:create_vo"

请问如何新建日历？

$params = [
            'create_vo' => [
                'summary' => '测试一个',
                'receiver_userids' => ["01040144291326"],
                'start_time' => time() * 1000 + 3600,
                'end_time' => time() * 1000 + 36000,
                'calendar_type' => 'notification',
                'source' => [
                    'title' => '测试的 呀',
                    'url' => 'http://www.dingtalk.com/page=xxx'
                ],
                'creator_userid' => "01040144291326",
                'uuid' => "01040144291326" . time(),
                'biz_id' => "123",
            ],
        ];
        dd($app->calendar->create($params));

提示错误：
array:3 [▼ "errcode" => 41 "errmsg" => "Invalid arguments:create_vo" "request_id" => "f87qrbvdj9rl" ]

根据userid获取用户详情出错

调用user->get()方法的时候返回SyntaxError: Unexpected number的错误

代码有问题吗？麻烦看一下

你好，测试了一下不行，配置都是正确的，在官方SDK都可以获取数据
代码如下：

require 'vendor/autoload.php';

use EasyDingTalk\Application;

$app = new Application([
    // 以下为必传配置项
    'agent_id' => 'XXXX',
    'app_key' => 'dingXXXX',
    'app_secret' => 'XXXX-XXXX',

    // 以下为非必须传入配置，请根据实际情况传入
    'http' => [
        'response_type' => 'array'
    ]
]);

$userId = 'XXXX';
$tuseruser = $app->user->get($userId);
var_dump($tuseruser);

钉钉扫码登录后，如何根据code获取用户的信息呢？

钉钉扫码登录后，如何根据code获取用户的信息呢？$app->user->getUserByCode()一直提示

“不存在的临时授权码””

请问有多个钉钉切换的功能吗？

目前有个需求，就是会有多个钉钉配置，分别操作，这样就会造成access_token一直失效的情况，有没有方法我可以将access_token获取到，在实例化的时候再将access_token注入呢？

请问有第三方企业应用相关的接口没

请问有第三方企业应用相关的接口没

获取子部门ID列表的数据接口数据不一致

获取子部门 ID 列表
https://oapi.dingtalk.com/department/list_ids?access_token=ACCESS_TOKEN&id=ID

此接口，获取的数据和官从官方地址获取的数据不一致，官方可以一次请求获取全部子列表，请更新；

请问如何设置 http client 的代理呢? 单位内部网络有管理,只能走http代理,谢谢

请问3.0支持企业内部定制应用开发吗

新版本移除了对eco.taobao.com的支持么？

目前钉钉有一些灰度接口是放置在https://eco.taobao.com/router/rest上面的，我看到新的版本目前对这部分不太支持？
是否有相关支持的计划？

需要升级以兼容 Laravel 6.0

Laravel 6.0 下，monolog 是 v2.0 的。
当前使用的 monolog ^1.23 无法正常使用
当前使用的 overture/http 也是升级到 1.1.3 来兼容 Laravel 6.0

使用Conversation\Client时无法发送钉钉消息

`
$params = [
'agent_id'=> 'xxxxx',
'userid_list' => 'xxxxxx',
'msg'=> json_encode(['msgtype'=> "text", 'text'=>['content'=> '测试 ']])
];

$res = $app->conversation->sendCorporationMessage($params);
print_r($res);
`
得到的结果：
array:3 [
"errcode" => 41
"errmsg" => "Invalid arguments:msg"
"request_id" => "skkfp0mdzlns"
]

将其中的postJson改为post即可

use Overtrue\Http\Client as BaseClient;

Class 'Overtrue\Http\Client' not found

机器人消息

机器人加签的情况没考虑进去

扫码登录第三方网站回调报错

使用的版本 mingyoung/dingtalk是2.3.0
使用的框架是laravel5.8
采用$user = $app->oauth->use('app-01')->user();获取回调的用户信息
但是报错
{"exception":"[object] (EasyDingTalk\Auth\InvalidStateException(code: 0): at /mnt/www/passport/vendor/mingyoung/dingtalk/src/Auth/OAuthClient.php:108)

code和state都是拿到的

请问怎么解决这个问题呢