DingTalk Interface and PHP Approval and Approval Application Development Guide

DingTalk Interface and PHP Approval and Approval Application Development Guide

DingTalk is a mobile office tool widely used within enterprises. It provides a rich interface to integrate with internal systems of enterprises. . In enterprises, review and approval processes are very common workflows. By combining the DingTalk interface with PHP, you can easily develop review and approval applications to improve work efficiency. This article will introduce how to use the DingTalk interface and PHP to develop approval and approval applications, and provide relevant code examples.

1. Preparation work

Before starting development, some preparation work is required.

1. DingTalk developer account: You need to have a DingTalk developer account. You can go to the DingTalk developer platform to register and apply.
2. DingTalk application creation: Create an internal enterprise application on the DingTalk developer platform, obtain the AppKey and AppSecret of the application, and set the callback URL of the application.
3. PHP development environment: Set up a PHP development environment to ensure that PHP code can be run.

2. DingTalk interface and PHP integration

DingTalk provides a series of interfaces through which interaction and communication with DingTalk can be achieved. In PHP, you can use the curl function to send HTTP requests to interact with DingTalk.

1. Authorized login

When users use the DingTalk application, they need to authenticate and log in first. You can use the interface provided by DingTalk to obtain the user's authorization information.

Sample code:

<?php
$appKey = 'your_app_key';
$appSecret = 'your_app_secret';
$redirectUri = 'http://your_callback_url';

$url = "https://oapi.dingtalk.com/connect/qrconnect?appid=".$appKey."&response_type=code&scope=snsapi_login&state=STATE&redirect_uri=".urlencode($redirectUri);

header("Location: ".$url);

In the above code, $appKey and $appSecret need to be replaced with the AppKey and AppSecret of your own application, $redirectUri needs to be replaced with the callback URL of your own application. By redirecting to the above URL through the header function, users can authorize login in DingTalk.

2. Get access token

Before using the DingTalk interface to perform other operations, you need to obtain the access token first. The access token is the credential for accessing the DingTalk interface.

Sample code:

<?php
$appKey = 'your_app_key';
$appSecret = 'your_app_secret';

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

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

$accessToken = $data['access_token'];

In the above code, $appKey and $appSecret need to be replaced with the AppKey and AppSecret of your own application. Send an HTTP request by calling the file_get_contents function, obtain the returned JSON data, and then parse out the access token.

3. Approval and approval application development example

The following takes a leave approval scenario as an example to demonstrate how to develop an approval and approval application.

1. Initiate leave application

After the user clicks the Initiate Leave button, the interface of DingTalk is called to create leave approval.

Sample code:

<?php
$accessToken = 'your_access_token';

$url = "https://oapi.dingtalk.com/topapi/processinstance/create?access_token=".$accessToken;

$data = array(
    'app_key' => 'your_app_key',
    'process_code' => 'your_process_code',
    'originator_user_id' => 'your_user_id',
    'dept_id' => 'your_dept_id',
    'form_component_values' => array(
        array(
            'name' => '请假类型',
            'value' => '事假'
        ),
        array(
            'name' => '请假时间',
            'value' => '2022-01-01 09:00:00'
        ),
        array(
            'name' => '请假时长',
            'value' => '1小时'
        ),
        array(
            'name' => '请假事由',
            'value' => '生病'
        )
    )
);

$data = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);

$data = json_decode($result, true);

$instanceId = $data['process_instance']['instance_id'];

In the above code, $accessToken needs to be replaced with your own access token, $data is when creating leave approval The request parameters, app_key, process_code, originator_user_id, dept_id need to be filled in according to the actual situation, form_component_values It is the form data for leave application.

Call the curl_exec function to send an HTTP request, and then parse the returned data to obtain the instance ID for leave approval.

2. Approval of leave application

After the approver receives the leave approval message in DingTalk, he or she can proceed with the approval operation.

Sample code:

<?php
$accessToken = 'your_access_token';

$url = "https://oapi.dingtalk.com/topapi/processinstance/action/start?access_token=".$accessToken;

$data = array(
    'instance_id' => 'your_instance_id',
    'userid' => 'your_user_id',
    'action_type' => 'agree',
    'remark' => '同意请假'
);

$data = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);

$data = json_decode($result, true);

if ($data['errcode'] == 0) {
    echo '审批成功';
} else {
    echo '审批失败：'.$data['errmsg'];
}

In the above code, $accessToken needs to be replaced with your own access token, $data is used when approving leave applications The request parameters, where instance_id is the instance ID for leave approval, userid is the user ID of the approver, action_type indicates the approval operation type, remark is the approval opinion.

Similarly call the curl_exec function to send an HTTP request, and parse the returned data to determine whether the approval is successful.

The above sample code is for demonstration purposes only. In actual development, it needs to be adapted and expanded according to specific needs.

Summary

By combining the DingTalk interface with PHP, we can easily develop approval and approval applications and improve work efficiency. This article introduces the integration method of DingTalk interface and PHP, and provides development examples of review and approval applications. I hope this article can be helpful to developers developing DingTalk applications.

The above is the detailed content of DingTalk Interface and PHP Approval and Approval Application Development Guide. For more information, please follow other related articles on the PHP Chinese website!