如何通过PandaDoc API在发送给收件人前预览并编辑文档

实现方案 #

你要的发送前文档预览编辑功能完全可以通过PandaDoc现有API实现，具体操作如下：

• 首先创建文档时保持文档为**草稿（draft）**状态，不要直接触发发送流程，草稿状态的文档支持编辑操作
• 如果你需要可视化的UI编辑界面，可调用你已经在用的创建会话接口，请求参数补充编辑权限配置：
  接口地址：https://api.pandadoc.com/public/v1/documents/{{document_id}}/session
  请求体示例参数：

  {
    "recipient": "你的发件人邮箱地址",
    "lifetime": 86400,
    "role": "sender"
  }
  

  接口返回的会话ID拼接为访问地址 https://app.pandadoc.com/document/session/{{返回的session_id}}，打开后即可直接预览、编辑草稿文档的内容、调整字段位置、修改收件人信息，所有改动会自动同步到对应文档。
• 如果你只需要后台批量修改文档字段内容无需UI操作，可直接调用字段更新接口：
  接口地址：https://api.pandadoc.com/public/v1/documents/{{document_id}}/fields
  用PUT请求传入你要修改的字段ID和对应值即可完成后台更新，无需打开前端页面。

注意事项 #

• 仅状态为draft的文档支持编辑操作，一旦调用发送接口将文档状态变更为sent后，就无法再修改文档内容
• 生成编辑会话时需确保你的API密钥拥有对应文档的编辑权限，否则会返回权限错误

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