Dropbox Sign API 面板

已更新 Oct 10, 2025

In this article

person icon

API 面板中的所有功能均面向所有套餐开放:测试模式(免费试用帐户)、Essentials、Standard 和 Premium。如需了解有关套餐和速率上限的更多信息,请访问 Dropbox Sign API 文档。您可以在此处查看有关套餐定价的更多信息。

实时模式与测试模式

在准备好启用应用之前,您可以先在测试模式中测试请求。这样有助于您确定工作流是否按照所需的方式运行,并支持您在应用上线之前管理出现的意外行为。

要显示在测试模式下发出的请求,请将切换按钮从“实时”切换到“测试”。您可以切换回实时模式,以实时网站中的事件填充 API 面板。

highlighter icon

注意:团队管理员和负责多个子团队的管理员可以使用管理员全局视图来查看和搜索归特定团队成员所有的 API 应用数据。详细了解如何通过 Sign API 面板使用管理员全局视图访问团队的 API 应用数据

数据分析

数据分析选项卡可为您提供 API 数据的总体视图。在此中心点,您可以快速查看 API 请求、签字请求状态以及整理成图表的签字请求使用情况。您可以使用页面顶部的下拉菜单,按数据类型、日期范围和错误状态(API 错误分布、端口或 HTTP 状态)自定义此数据的时间线视图;也可以查看应用和帐户活动的日志。

您还可以在数据分析选项卡中查看限额使用情况(剩余的签字请求)和基本结算信息。

 

签字请求状态

您可以在签字请求状态选项卡中查看文档 ID、签字请求状态以及事件的日期和时间。您还可以使用此页面顶部的下拉菜单,按日期和签字请求状态筛选此页面上的信息。

 

应用回调

应用回调选项卡有助于您设置和监控您的用户界面 (UI) 交互情况,为您提供有关嵌入式功能使用情况的详细信息。

当与特定应用关联的编程操作(即“事件”)发生时,应用回调将触发。此选项卡仅整理显示嵌入式请求的信息。

详细了解回调以及如何在 Dropbox API 面板中进行设置。

 

帐户回调

帐户回调选项卡有助于您设置和监控服务器事件,以简化工作流并最大限度缩短延迟时间。

发生涉及您帐户的事件时,帐户回调会将事件负载发送至您的帐户回调 URL,从而通知您的应用程序——换句话说,是在事件中包含的数据完整生成时。您可以点击下拉菜单,按日期和事件类型筛选帐户回调。

您可以使用帐户 API 调用来设置帐户回调 URL 或在设置页面上手动进行设置。

详细了解回调以及如何在 Dropbox API 面板中进行设置。

 

API 请求

API 请求选项卡将向您提供已发送请求的功能快照,以便您快速搜索并处理任何请求错误。

您可以使用页面顶部的下拉菜单,按日期、HTTP 状态、方法和端口筛选 API 请求。

HTTP 代码代表您的浏览器和服务器之间的交互状态。借助 API 面板,您可以按 HTTP 状态代码筛选请求,以清晰了解哪些请求需要重点关注,以及哪些请求正按要求运行。

以下是 HTTP 状态的具体含义:

  • Informational状态表示服务器尚未完成请求(代码 100-199)。
  • Success状态表示服务器请求已完成且没有错误(代码 200-299)。
  • Redirectional状态表示请求已收到,但随后已重定向至其他位置(代码 300-399)。
  • Client error状态表示无法访问该页面。这是网站方面的错误,通常在网站页面不存在时发生(代码 400-499)。
  • Server error错误状态表示已发出有效请求,但服务器未能按预期完成该请求(代码 500-599)。

您也可以按方法筛选签字请求:

  • GET 用于检索或读取资源。
  • POST 用于创建新资源。
  • DELETE 用于删除整个资源。
  • PUT 用于修改整个资源。
  • PATCH 用于修改部分资源。

要按端口筛选请求,请执行以下操作:

  1. 创建此视图所需的任何其他请求参数(日期、HTTP 状态、方法)。
  2. 单击端口
  3. 单击自定义
  4. 单击任意适用端口旁边的复选框。
  5. 单击应用

您可以在签字请求概述中查看可用的端口列表。

 

签字请求使用情况

签字请求可用于引用请求特定的数据,包括签字人的姓名和电子邮件地址、自定义字段、元数据、响应数据以及创建和完成请求的时间戳。您可以按日期和客户端 ID 筛选使用情况数据。

highlighter icon

注意:签字请求的使用情况也在您的团队动态页面上以图表形式显示。

应用和密钥

“应用和密钥”选项卡会将您重定向至“设置”页面,您可以在其中查看和管理已关联应用和 API 密钥。

详细了解如何创建和管理多个 API 密钥。

 

CSV 下载

“CSV 下载”选项卡显示了您的帐户在自定义日期范围内的签字请求历史记录。您可以将此列表导出为 .csv 文件。

操作方法如下:

  1. 登录 Dropbox Sign 。
  2. 点击“API”。
  3. 点击“查看 API 面板”。
  4. 点击“CSV 下载”。
  5. 输入要导出的数据的日期范围。
  6. 点击“下载 CSV”。

访问 Dropbox Sign API 面板以开始使用。

 

相关资源

  • 如需详细了解可用功能和 API 面板的使用方法,请参阅 API 面板指南。
  • 如需了解有关设置和运行 Dropbox Sign API 的更多信息,请查看 API 快速入门。

如有任何疑问或要报告任何问题,请在这里提交请求。

这篇文章有用吗?

请告诉我们为什么它没有帮助:

感谢您告诉我们!

谢谢您的意见!

获取帮助的其他方式