关于Mendeley API实现PDF注释导入导出及格式的技术问询

1. 分别下载PDF文件与注释 #

• PDF文件：调用documents/{id}/file端点可获取目标文献的PDF二进制流，直接保存即可完成下载，需确保该文献的PDF已存入你的库且你拥有访问权限。
• 注释：通过documents/{id}/annotations端点获取该文献的所有注释数据，返回结果为JSON格式，包含注释类型、位置、内容、创建时间等结构化信息，可单独导出保存。

2. 上传PDF文件及对应注释 #

• PDF文件：先通过documents端点创建新文献条目（或匹配已有条目），再调用documents/{id}/file端点上传PDF二进制文件，完成PDF导入。
• 对应注释：PDF上传完成后，向documents/{id}/annotations端点发送POST请求，提交符合Mendeley注释结构的JSON数据，即可将注释关联到目标文献。需保证注释的页码、坐标范围与上传的PDF完全匹配，否则注释无法正常显示。

3. 注释格式与自定义应用导入可行性 #

Mendeley API采用结构化标准注释格式，核心字段包括：

• type：注释类型（如highlight、note、underline）
• text：注释内容（笔记文本或高亮片段）
• page：注释所在页码
• position：页面坐标范围（含top、left、width、height参数）
• color：注释颜色标识（如#FFFF00代表黄色高亮）

你可以通过自定义应用生成符合上述结构的JSON注释数据，通过API提交后，Mendeley网页端会自动同步并展示这些注释，无需额外适配操作。

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