Tutorial on integration of DingTalk interface and PHP

Integration tutorial of DingTalk interface and PHP

With the development of mobile phone intelligence, mobile office has become an indispensable part of the enterprise. As a mobile office application specially built for enterprises, DingTalk has been favored by many enterprises due to its stable system and powerful functions. DingTalk provides a wealth of interfaces that can be easily integrated with an enterprise's own system. This article will introduce how to use PHP language to integrate with the DingTalk interface to implement some common functions.

1. Get access_token
   Before using the DingTalk interface, we need to obtain the access_token first, because each interface requires this parameter. access_token is equivalent to our credentials for accessing the DingTalk interface and needs to be refreshed regularly. The interface for obtaining access_token is:

<?php
  // 定义常量
  define('CORPID', 'your_corp_id'); // 企业ID，在钉钉开发者后台获取
  define('SECRET', 'your_secret'); // 企业应用的凭证秘钥，也在钉钉开发者后台获取

  // 获取access_token
  function getAccessToken(){
      $url = 'https://oapi.dingtalk.com/gettoken?corpid='.CORPID.'&corpsecret='.SECRET;
      $result = file_get_contents($url);
      $result_obj = json_decode($result);
      return $result_obj->access_token;
  }
  
  // 使用示例
  $access_token = getAccessToken();
  echo $access_token;
?>

2. Send corporate messages
   DingTalk provides an interface for sending corporate messages, which can send text, links and other messages to designated users or departments. The following is a sample code for sending a text message:

<?php
  // 发送企业消息
  function sendTextMsg($access_token, $agent_id, $userid_list, $content){
      $url = 'https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token='.$access_token;
      $data = array(
          'agent_id' => $agent_id, // 企业应用的agent_id，在钉钉开发者后台获取
          'userid_list' => $userid_list, // 发送消息的用户列表，多个用户用英文逗号分隔
          'msg' => array(
              'msgtype' => 'text',
              'text' => array(
                  'content' => $content
              )
          )
      );
      $data_json = json_encode($data);
      $result = http_post($url, $data_json);
      return $result;
  }

  // 发送HTTP POST请求
  function http_post($url, $data){
      $ch = curl_init($url);
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
      curl_setopt($ch, CURLOPT_POST, 1);
      curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
      curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
      $result = curl_exec($ch);
      curl_close($ch);
      return $result;
  }

  // 使用示例
  $access_token = getAccessToken();
  $agent_id = 'your_agent_id';
  $userid_list = 'user1,user2,user3';
  $content = '这是一条测试消息';
  $result = sendTextMsg($access_token, $agent_id, $userid_list, $content);
  var_dump($result);
?>

3. Get the list of department members
   DingTalk provides an interface to get the list of department members, which can get all the member information under the specified department. . The following is a sample code to obtain a list of department members:

<?php
  // 获取部门成员列表
  function getDepartmentMembers($access_token, $department_id){
      $url = 'https://oapi.dingtalk.com/user/simplelist?access_token='.$access_token.'&department_id='.$department_id;
      $result = file_get_contents($url);
      $result_obj = json_decode($result);
      return $result_obj;
  }

  // 使用示例
  $access_token = getAccessToken();
  $department_id = 'your_department_id';
  $result = getDepartmentMembers($access_token, $department_id);
  var_dump($result);
?>

Through the above sample codes, we can see how to use PHP language to integrate with the DingTalk interface to send corporate messages and obtain department members List function. Of course, DingTalk's interface has many other functions. If you need more detailed interface documentation and sample code, you can visit DingTalk's developer documentation and select the corresponding interface and parameters to call as needed.

Summary
This article takes the integration of DingTalk interface and PHP as an example to introduce how to obtain access_token, send corporate messages and obtain a list of department members, and gives corresponding code examples. Through study and practice, I believe readers have mastered the basic skills of how to use PHP language to integrate with the DingTalk interface. In actual development, more functions and extensions can be achieved based on specific needs and combined with the documentation of the DingTalk interface. I hope this article will be helpful to readers, and I also hope that everyone can combine the DingTalk interface with their own systems to bring a more efficient and convenient mobile office experience to enterprises.

The above is the detailed content of Tutorial on integration of DingTalk interface and PHP. For more information, please follow other related articles on the PHP Chinese website!