michonnehsu/simpledingtalk

A modern DingTalk API client with better architecture and error handling

2.0 2026-01-10 01:43 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.16
• monolog/monolog: ^2.0
• phpmd/phpmd: ^2.8
• phpstan/phpstan: ^0.12
• phpunit/phpunit: ^9.0
• squizlabs/php_codesniffer: ^3.5

MIT

• Michonne Hsu

• api
• client
• messaging
• enterprise
• dingtalk

README

轻量级钉钉服务端PHP-SDK，简化初学者的使用难度。

介绍

这是一款PHP编写的轻量级钉钉服务端扩展包，以最简单的方式取调用、源码易懂、模块化。
用户可以自行定期更新token或应用自行判断，达到使用接口函数不需要考虑token的问题。

安装方式

composer require michonnehsu/simpledingtalk

文档地址

点击访问文档

用法

require './vendor/autoload.php';


use SimpleDingTalk\SimpleDingTalk;
use SimpleDingTalk\Storage\FileTokenStorage;
try {
    // 基础配置
    $config = [
        'app_key' => '',
        'app_secret' => '',
        'agent_id' => 0,
        'debug' => true,
        'redirect_uri'=>'https://www.dingtalk.com',
        'domain'=>'https://www.dingtalk.com'
    ];
    $fts=new FileTokenStorage('dingtalk');
    $dingtalk = new SimpleDingTalk($config,$fts);

    $data=[
        'dept_id'=>1
    ];
    $departmentInfo=$dingtalk->department()->get($data);

    print_r($departmentInfo);
    
} catch (\SimpleDingTalk\Exceptions\ApiException $e) {
    echo "API错误: " . $e->getMessage() . " (错误码: " . $e->getApiCode() . ")\n";
} catch (\Exception $e) {
    echo "错误: " . $e->getMessage() . "\n";
}

如何配置以及使用

QQ群

群号 815471943