PHP cURL 集成 Dropbox API：高效获取文件夹文件列表

{
    "path": "/Homework/math",
    "recursive": false,
    "include_media_info": false,
    "include_deleted": false,
    "include_has_explicit_shared_members": false,
    "include_mounted_folders": true,
    "include_non_downloadable_files": true
}

<?php

// 替换为您的 Dropbox API 访问令牌
// 访问令牌通常以 "sl." 或 "oauth2:" 开头
$accessToken = 'YOUR_DROPBOX_ACCESS_TOKEN'; 

// 定义请求的 API 端点
$apiUrl = 'https://api.dropboxapi.com/2/files/list_folder';

// 定义 POST 请求体中的数据
// 注意：这里直接构建一个 JSON 字符串
$postData = json_encode([
    'path'                           => '/Homework/math', // 要列出的文件夹路径
    'recursive'                      => false,            // 是否递归列出子文件夹
    'include_media_info'             => false,            // 是否包含媒体信息
    'include_deleted'                => false,            // 是否包含已删除文件
    'include_has_explicit_shared_members' => false,       // 是否包含显式共享成员信息
    'include_mounted_folders'        => true,             // 是否包含挂载的文件夹
    'include_non_downloadable_files' => true              // 是否包含不可下载的文件
]);

// 初始化 cURL 会话
$ch = curl_init();

// 设置 cURL 选项
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // 将响应作为字符串返回，而不是直接输出
curl_setopt($ch, CURLOPT_POST, 1);           // 设置为 POST 请求
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData); // 设置 POST 请求体，必须是 JSON 字符串

// 设置 HTTP 请求头
$headers = [
    'Authorization: Bearer ' . $accessToken, // 授权令牌
    'Content-Type: application/json'         // 声明请求体是 JSON 格式
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

// 执行 cURL 请求并获取结果
$result = curl_exec($ch);

// 检查是否有 cURL 错误
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    // 打印或处理 API 响应
    echo "Dropbox API Response:\n";
    echo $result;

    // 如果响应是 JSON，可以解码它
    $responseDecoded = json_decode($result, true);
    if (json_last_error() === JSON_ERROR_NONE) {
        echo "\n\nDecoded Response:\n";
        print_r($responseDecoded);
        // 遍历文件和文件夹
        if (isset($responseDecoded['entries']) && is_array($responseDecoded['entries'])) {
            echo "\n\nFiles and Folders:\n";
            foreach ($responseDecoded['entries'] as $entry) {
                echo "- " . $entry['.tag'] . ": " . $entry['name'] . " (ID: " . $entry['id'] . ")\n";
            }
        }
    } else {
        echo "\n\nFailed to decode JSON response.\n";
    }
}

// 关闭 cURL 会话
curl_close($ch);

?>