根据路径获取人类可读路径 (getHPathByPath)

接口描述

本接口用于根据文档的物理路径（path）获取其人类可读路径（HPath）。HPath 是文档在笔记本中的层级结构路径，以文档标题组成，例如 /笔记/子文件夹/文档标题。

与物理存储路径（如 /20210808180117-czj9bvb/20200813125239-hbwpz87.sy）不同，HPath 更易于用户理解和记忆。

此接口常用于将系统内部使用的 ID 路径转换为用户可读的路径，便于在用户界面中展示。

请求参数

请求体为一个 JSON 对象，包含以下字段：

响应体

成功时，响应体为一个 JSON 对象，包含以下字段：

请求示例

{
  "notebook": "20200812223209-lj3enxa",
  "path": "/20210808180117-czj9bvb/20200813125239-hbwpz87.sy"
}
            

响应示例

成功响应：

{
  "code": 0,
  "msg": "",
  "data": "/笔记/待办事项/项目计划"
}
            

失败响应（笔记本不存在）：

{
  "code": -1,
  "msg": "笔记本不存在",
  "data": null
}
            

失败响应（路径不存在）：

{
  "code": -1,
  "msg": "文档不存在",
  "data": null
}
            

错误码

源码定位

后端实现相关的核心逻辑可以在以下文件中找到：

• 路由定义：siyuan/kernel/api/router.go（路由 /api/filetree/getHPathByPath）
• API 处理函数：siyuan/kernel/api/filetree.go（函数 getHPathByPath）
• 模型层实现：siyuan/kernel/model/file.go（函数 GetHPathByPath）
• 对相关功能的支持：siyuan/kernel/treenode/blocktree.go（函数 GetBlockTreeByPath）