DingTalk インターフェースのドッキングの実践: PHP 開発のために知っておくべきこと

DingTalk インターフェイスのドッキングの実践: PHP 開発について知っておくべきこと

DingTalk は、企業内でのコミュニケーションとコラボレーションを促進するための豊富なインターフェイスと機能を提供する、広く使用されている企業コミュニケーション ツールです。 PHP 開発者にとって、DingTalk インターフェイスのドッキングは重要なスキルです。この記事では、DingTalk インターフェイスのドッキングについて知っておくべきことをいくつか紹介し、PHP 開発用のコード例をいくつか示します。

1. access_token の取得

DingTalk インターフェイスに接続する前に、まず access_token を取得する必要があります。 access_token は、DingTalk インターフェイスにアクセスするための ID 資格情報です。インターフェイスが要求されるたびに、Access_token をパラメーターとして渡す必要があります。

access_token を取得するためのインターフェースアドレスは:

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

このうち、APPKEY と APPSECRET は、DingTalk 開発者プラットフォームでアプリケーションを作成するときに取得した値に置き換える必要があります。以下はサンプル コードです:

<?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. メッセージの送信

DingTalk は、テキスト、リンク、マークダウン、画像などを含むさまざまなメッセージ タイプを提供します。メッセージを送信するためのインターフェイス アドレスは次のとおりです。

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

ACCESS_TOKEN を、前の手順で取得した access_token に置き換える必要があります。以下は、テキスト メッセージを送信するためのサンプル コードです。

<?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. コールバックの受信

DingTalk は、より複雑なビジネス ロジックを実装するためのコールバック情報の受信もサポートしています。コールバック情報を受信するためのインターフェイス アドレスは次のとおりです。

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

ACCESS_TOKEN を、前の手順で取得した access_token に置き換える必要があります。以下は、コールバック メッセージを受信するためのサンプル コードです。

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

概要:

DingTalk インターフェイスのドッキングは、PHP 開発者に必要なスキルの 1 つです。この記事では、access_token の取得、メッセージの送信、コールバックの受信のための基本的なプロセスとコード例をいくつか紹介します。これらの必知事項を学び、実践することで、開発者は DingTalk インターフェイスをより適切に使用して、さまざまなエンタープライズ コミュニケーションおよびコラボレーション機能を実装できるようになります。この記事が皆さんのお役に立てれば幸いです!

以上がDingTalk インターフェースのドッキングの実践: PHP 開発のために知っておくべきことの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。