DingTalk interface docking practice: Things you must know for PHP development

DingTalk interface docking practice: Things you must know about PHP development

DingTalk is a widely used enterprise communication tool that provides a wealth of interfaces and functions to facilitate communication and collaboration within the enterprise. . For PHP developers, DingTalk interface docking is an important skill. This article will introduce some things you must know about DingTalk interface docking, and provide some code examples for PHP development.

1. Get access_token

Before connecting to the DingTalk interface, you first need to obtain the access_token. access_token is the identity credential for accessing the DingTalk interface. Access_token needs to be passed as a parameter every time the interface is requested.

The interface address for obtaining access_token is:

https://oapi.dingtalk.com/gettoken?appkey=APPKEY&appsecret=APPSECRET

Among them, APPKEY and APPSECRET need to be replaced with the values ​​obtained when you create the application on the DingTalk developer platform. The following is a sample code:

<?php
$appKey = "APPKEY";
$appSecret = "APPSECRET";
$url = "https://oapi.dingtalk.com/gettoken?appkey=".$appKey."&appsecret=".$appSecret;

$response = file_get_contents($url);
$data = json_decode($response, true);

$accessToken = $data['access_token'];

echo "Access Token: " . $accessToken;
?>

2. Send a message

DingTalk provides a variety of message types, including text, links, Markdown, images, etc. The interface address for sending messages is:

https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN

You need to replace ACCESS_TOKEN with the access_token obtained in the previous step. The following is a sample code for sending a text message:

<?php
$accessToken = "ACCESS_TOKEN";
$url = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=".$accessToken;

$payload = [
    'agent_id' => 123456, // 应用agentId
    'userid_list' => 'user1,user2', // 用户ID，多个以逗号分隔
    'msg' => [
        'msgtype' => 'text',
        'text' => [
            'content' => '这是一条测试消息',
        ],
    ],
];

$options = [
    'http' => [
        'header' => 'Content-Type:application/json',
        'method' => 'POST',
        'content' => json_encode($payload),
    ],
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$data = json_decode($response, true);

if ($data['errcode'] == 0) {
    echo "消息发送成功";
} else {
    echo "消息发送失败：" . $data['errmsg'];
}
?>

3. Receive callback

DingTalk also supports receiving callback information to implement more complex business logic. The interface address for receiving callback information is:

https://oapi.dingtalk.com/call_back/register_call_back?access_token=ACCESS_TOKEN

You need to replace ACCESS_TOKEN with the access_token obtained in the previous step. The following is a sample code for receiving callback messages:

<?php
$accessToken = "ACCESS_TOKEN";
$url = "https://oapi.dingtalk.com/call_back/register_call_back?access_token=".$accessToken;

$payload = [
    'call_back_tag' => ['user_add_org'], // 需要监听的事件类型
    'token' => 'YOUR_TOKEN', // 验证回调URL的token
    'aes_key' => 'YOUR_AES_KEY', // 验证回调URL的密钥
    'url' => 'YOUR_CALLBACK_URL', // 回调URL
];

$options = [
    'http' => [
        'header' => 'Content-Type:application/json',
        'method' => 'POST',
        'content' => json_encode($payload),
    ],
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$data = json_decode($response, true);

if ($data['errcode'] == 0) {
    echo "回调注册成功";
} else {
    echo "回调注册失败：" . $data['errmsg'];
}
?>

Summary:

DingTalk interface docking is one of the necessary skills for PHP developers. This article introduces some basic processes and code examples for obtaining access_token, sending messages and receiving callbacks. By learning and practicing these must-know things, developers can better use the DingTalk interface to implement various enterprise communication and collaboration functions. I hope this article can be helpful to everyone!

The above is the detailed content of DingTalk interface docking practice: Things you must know for PHP development. For more information, please follow other related articles on the PHP Chinese website!