Notion API数据库查询：PHP cURL过滤参数的正确实践

{
  "property": "DataElement",
  "title": {
    "equals": "bigHouse"
  }
}

{
  "filter": {
    "property": "DataElement",
    "title": {
      "equals": "bigHouse"
    }
  }
}

<?php

// 连接信息（请替换为您的实际值）
$databaseId = "YOUR_DATABASE_ID"; // Notion数据库ID
$url = "https://api.notion.com/v1/databases/$databaseId/query"; // API端点
$token = 'YOUR_NOTION_API_TOKEN'; // Notion集成令牌
$version = '2022-06-28'; // Notion API版本，建议使用最新稳定版本

// 构建请求数据数组，将过滤条件封装在 'filter' 键中
$data_array = [
    'filter' => [
        "property" => "DataElement", // 数据库属性名
        "title" => [ // 属性类型为Title的过滤条件
            "equals" => "bigHouse" // 标题等于"bigHouse"
        ]
    ]
];

// 将PHP数组转换为JSON字符串
$data = json_encode($data_array);

// ... (后续cURL请求代码)

?>

<?php
// ... (之前的代码)

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

// 设置URL
curl_setopt($ch, CURLOPT_URL, $url);
// 设置为返回响应内容，而不是直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 设置为POST请求
curl_setopt($ch, CURLOPT_POST, true);
// 设置POST请求体
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

// 设置HTTP请求头
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Bearer ' . $token, // 认证令牌
    'Notion-Version: ' . $version,     // API版本
    'Content-Type: application/json'   // 明确指定请求体为JSON
));

// 在开发环境中，为避免SSL证书验证问题，可以禁用以下选项。
// 在生产环境中，强烈建议启用SSL验证。
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 验证主机名
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); // 验证对等证书

// ... (后续cURL执行和错误处理代码)

?>

<?php
// ... (之前的代码)

// 执行cURL请求
$resp = curl_exec($ch);

// 检查cURL是否有错误
if ($e = curl_error($ch)) {
    echo "cURL Error: " . $e;
} else {
    // 解码JSON响应
    $decoded = json_decode($resp, true);

    // 检查JSON解码是否成功
    if (json_last_error() === JSON_ERROR_NONE) {
        echo "<pre>";
        var_dump($decoded); // 打印解码后的响应数据
        echo "</pre>";
    } else {
        echo "JSON Decode Error: " . json_last_error_msg();
        echo "Raw Response: " . $resp;
    }
}

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

?>

<?php

// --- 配置信息 ---
$databaseId = "YOUR_DATABASE_ID"; // 替换为您的Notion数据库ID
$token = 'YOUR_NOTION_API_TOKEN'; // 替换为您的Notion集成令牌
$version = '2022-06-28'; // Notion API版本，建议使用最新稳定版本

$url = "https://api.notion.com/v1/databases/$databaseId/query"; // Notion API查询端点

// --- 构建请求数据 ---
// 关键：将过滤条件封装在 'filter' 键中
$data_array = [
    'filter' => [
        "property" => "DataElement", // 替换为您的Notion数据库属性名
        "title" => [ // 假设 'DataElement' 属性类型为 'Title'
            "equals" => "bigHouse" // 查找标题等于 "bigHouse" 的条目
        ]
    ]
];

// 将PHP数组转换为JSON字符串
$data = json_encode($data_array);

// --- 初始化并配置 cURL ---
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回响应内容
curl_setopt($ch, CURLOPT_POST, true);         // 设置为POST请求
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);  // 设置POST请求体

// 设置HTTP请求头
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Bearer ' . $token,         // 认证令牌
    'Notion-Version: ' . $version,             // API版本
    'Content-Type: application/json'           // 明确指定请求体为JSON
));

// --- SSL 验证设置 (生产环境强烈建议启用) ---
// 在开发环境中，为避免SSL证书验证问题，有时会禁用以下选项。
// 生产环境中应始终启用以确保安全。
// curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
// curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
// 如果您的环境SSL证书有问题，可以暂时禁用（不推荐在生产环境）：
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

// --- 执行请求并处理响应 ---
$resp = curl_exec($ch);

if ($e = curl_error($ch)) {
    echo "cURL Error: " . $e;
} else {
    $decoded = json_decode($resp, true);

    if (json_last_error() === JSON_ERROR_NONE) {
        echo "<h2>Notion API Query Result:</h2>";
        echo "<pre>";
        var_dump($decoded);
        echo "</pre>";
        // 可以进一步处理 $decoded['results'] 来获取实际的数据库条目
    } else {
        echo "<h2>JSON Decode Error:</h2>";
        echo "Error: " . json_last_error_msg() . "<br>";
        echo "Raw Response: " . htmlspecialchars($resp);
    }
}

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

?>