PHP集成Notion API：数据库查询过滤实战指南

// 错误的请求数据结构示例
$data_array =
[
  "property"=>"DataElement",
  "title"=>["equals"=>"bigHouse"]
];

$data = json_encode($data_array);
// 此时 $data 的输出可能为：{"property":"DataElement","title":{"equals":"bigHouse"}}
// 这种结构不符合Notion API的过滤要求

// 正确的请求数据结构
$data_array =
[
  'filter' =>
    [
      "property"=>"DataElement",
      "title"=>["equals"=>"bigHouse"]
    ]
];

$data = json_encode($data_array);
// 此时 $data 的输出为：{"filter":{"property":"DataElement","title":{"equals":"bigHouse"}}}
// 这种结构才能被Notion API正确解析并执行过滤

<?php

// 数据库和API连接信息（请替换为您的实际值）
$databaseId = "YOUR_DATABASE_ID"; // 您的Notion数据库ID
$url = "https://api.notion.com/v1/databases/$databaseId/query"; // Notion API查询端点
$token = 'YOUR_NOTION_INTEGRATION_TOKEN'; // 您的Notion集成令牌
$version = '2021-08-16'; // Notion API版本

// 构建包含过滤条件的请求数据
// 目标：查询名为 "DataElement" 的标题属性等于 "bigHouse" 的条目
$data_array =
[
  'filter' =>
    [
      "property"=>"DataElement", // 要过滤的属性名称
      "title"=>["equals"=>"bigHouse"] // 过滤条件：标题等于 "bigHouse"
    ]
];

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

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

// 设置cURL选项
curl_setopt($ch, CURLOPT_URL, $url); // 设置请求URL
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 将响应作为字符串返回，而不是直接输出
curl_setopt($ch, CURLOPT_POST, true); // 设置为POST请求
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // 设置POST请求体数据

// 设置HTTP头部，包括认证信息和API版本
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Bearer ' . $token, // API认证令牌
    'Notion-Version: ' . $version, // 指定Notion API版本
    'Content-Type: application/json' // 声明请求体为JSON格式
));

// 注意：以下两行用于禁用SSL证书验证，仅在开发或特定环境下使用，
// 生产环境中强烈建议启用并正确配置SSL证书验证以确保安全。
// curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
// curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

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

// 检查cURL请求是否发生错误
if($e = curl_error($ch))
{
    echo "cURL Error: " . $e;
} else
{
    // 解码JSON响应
    $decoded = json_decode($resp, true);
    echo "<h2>查询结果:</h2>";
    var_dump($decoded); // 打印解码后的数据
}

// 打印发送的原始JSON数据（用于调试）
echo "<br><h2>发送的JSON数据:</h2>";
echo $data;

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

?>