如何按Notion UI中的拖拽顺序查询Notion数据库？

Notion的手动拖拽排序对应其内置的position字段，但默认查询不会按该字段排序，也不会主动返回它。以下是可行的解决步骤：

• 调用Notion数据库查询API（/v1/databases/{database_id}/query）时，在请求体中添加sort参数，指定按position字段排序：

  {
    "sort": [
      {
        "property": "position",
        "direction": "ascending"
      }
    ]
  }
  

  这里的ascending对应Notion界面中从上到下（或从左到右）的拖拽顺序，descending则是反向排序。

• 特殊场景适配：

  • 若使用看板视图，拖拽排序是基于列内的位置，此时需要将sort中的property指定为看板列对应的属性名，同时保持direction设置。
  • 确保数据库的默认排序未覆盖手动拖拽规则，若有多个视图，可在API请求中指定对应视图ID，或者直接忽略视图，按全局position排序。

• 结果验证：
  请求后检查返回的页面数据，确认properties中包含position字段，且排序结果与Notion中拖拽的顺序一致。如果仍有偏差，检查是否存在其他排序规则（如日期、名称）被设置为视图默认，此时需先在Notion中把手动排序设为视图的默认排序。

内容的提问来源于stack exchange，提问作者Thanh Long