Pratique d'accueil de l'interface DingTalk : choses que vous devez savoir pour le développement PHP

Pratique d'accueil d'interface DingTalk : choses que vous devez savoir sur le développement PHP

DingTalk est un outil de communication d'entreprise largement utilisé, qui fournit une multitude d'interfaces et de fonctions pour faciliter la communication et la collaboration au sein de l'entreprise. Pour les développeurs PHP, l'accueil de l'interface DingTalk est une compétence importante. Cet article présentera certaines choses que vous devez savoir sur l'accueil de l'interface DingTalk et fournira quelques exemples de code pour le développement PHP.

1. Obtenir access_token

Avant de vous connecter à l'interface DingTalk, vous devez d'abord obtenir l'access_token. access_token est l'identifiant d'identité permettant d'accéder à l'interface DingTalk. Access_token doit être transmis en tant que paramètre à chaque fois que l'interface est demandée.

L'adresse de l'interface pour obtenir access_token est :

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

Parmi eux, APPKEY et APPSECRET doivent être remplacés par les valeurs obtenues lors de la création de l'application sur la plateforme de développement DingTalk. Voici un exemple de 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. Envoyer un message

DingTalk propose une variété de types de messages, notamment du texte, des liens, du Markdown, des images, etc. L'adresse de l'interface pour l'envoi des messages est :

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

Vous devez remplacer ACCESS_TOKEN par le access_token obtenu à l'étape précédente. Voici un exemple de code pour envoyer des messages texte :

<?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. Recevoir un rappel

DingTalk prend également en charge la réception d'informations de rappel pour implémenter une logique métier plus complexe. L'adresse de l'interface pour recevoir les informations de rappel est :

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

Vous devez remplacer ACCESS_TOKEN par le access_token obtenu à l'étape précédente. Voici un exemple de code pour recevoir des messages de rappel :

<?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'];
}
?>

Résumé :

L'amarrage de l'interface DingTalk est l'une des compétences nécessaires pour les développeurs PHP. Cet article présente quelques processus de base et des exemples de code pour obtenir access_token, envoyer des messages et recevoir des rappels. En apprenant et en mettant en pratique ces éléments incontournables, les développeurs peuvent mieux utiliser l'interface DingTalk pour mettre en œuvre diverses fonctions de communication et de collaboration d'entreprise. J'espère que cet article pourra être utile à tout le monde !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!