V2
删除页面
将页面移入回收站,并返回软删除结果。
删除页面
适用场景
当你要把页面移入回收站,而不是永久删除时,使用这个接口。它适合需要保留恢复能力的场景。
接口信息
| 项目 | 内容 |
|---|---|
| 方法 | DELETE |
| 路径 | /v2/pages/:page_id |
| 请求体 | 无 |
| 返回 | page 删除结果 |
| Scope | pages.write |
权限要求
需要 pages.write。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
page_id | string | 是 | 页面 ID。 |
响应结果
{
"object": "page",
"id": "22222222-2222-4222-8222-222222222222",
"in_trash": true
}
行为说明或限制
- 这是软删除,不会物理删除数据。
- 页面下的子页面和子块也会一并进入回收站。
- 如果页面已经在回收站中,重复删除仍会返回成功结果。
错误提示
401 unauthorized:token 无效或已过期。403 forbidden:缺少pages.write或无权访问该页面。404 not_found:页面不存在。
