文章

最大化Smartsheet API集成的提示

通过泰勒Krusen

两位智能表开发者倡导者出席了ENGAGE'18

我们的许多客户都使用智能表应用程序编程接口(API)建立流程来组织和加速他们的工作流程,这样他们的团队就可以产生更大的影响。但是,如果您需要在整个组织中自动化和扩展工作流,该怎么办呢?

一旦您超越了Smartsheet API的基础知识,您就可以学习更高级的策略,从而使您的公司整体受益。虽然从为自己构建集成到为他人构建集成的转变可能具有挑战性,但回报肯定是值得努力的。

继续阅读,了解如何建立与Smartsheet API的安全连接,然后自动化流程并优化集成以实现扩展。

1.使用OAuth Flow保护您的数据

使用您的集成的人需要能够以安全可靠的方式与他们的智能表数据进行交互。OAuth 2.0标准是一个开放的、得到广泛支持的授权协议,有助于提高与第三方应用程序的安全连接。

实现Smartsheet OAuth Flow意味着其他人可以使用您的集成与他们的Smartsheet数据进行交互,而无需实际转手任何敏感信息(用户名,密码等)。

自从你第一次OAuth流使用Smartsheet API可能有点棘手,我们创建了这个Node.js中的智能表OAuth流教程,以帮助您开始。


相关的

准入和安全的竞争力量


2.使用webhook自动化流程

另一个重要的考虑因素是过程自动化,特别是如果您的集成需要响应智能表数据的变化。目前,有两个选项可供您选择:

  1. 定期调用Smartsheet API来检查更改(使用)获取工作表版本)。

  2. 通过使用Smartsheet自动获得更改通知人则

我们强烈建议使用webhook,这是更有效的选择。这webhook实现示例是在本地构建和测试webhook的一个很好的起点。在撰写本文时,webhook的范围仅限于表单上的所有事件。换句话说,webhook只能监听单个工作表上的更改,并将根据对工作表的所有保存的更改触发。

webhook的有效载荷是故意的:它告诉你哪里发生了变化,而不是发生了什么变化。您需要对Smartsheet API进行第二次调用,以将相关的工作表数据拉入您的集成中。


相关的

为FedRAMP连接计划选择的智能表


3.扩展集成

如果您的集成将被其他人使用,那么您必须仔细考虑它将如何处理繁重的负载。具体来说,您需要考虑您的集成将如何与更高容量的Smartsheet API进行交互。

这可以归结为三个主要问题:明智地使用API,拥有一个日志记录系统,优雅地处理错误。对你来说,在调用Smartsheet API时慎重而高效也很重要。许多端点都可以执行批量操作,从而允许合并调用。


相关的

智能表开发人员门户


例如,您可以在具有60行的对象上调用一次Update Rows,而不是更新单行60次。使用批量操作可以获得更好的性能,防止保存错误,并避免达到速率限制。

在撰写本文时,Smartsheet API实现了每分钟300个请求的限制(这可能会发生变化)。处理速率限制错误的最佳策略是等待并重试呼叫。

处理速率限制错误是在使用API时使用Smartsheet SDK(软件开发工具包)的众多原因之一。每个SDK (c#JavaPython鲁比(人名),JavaScript)包含在引发速率限制错误时的重试逻辑。使用SDK的另一个重要原因是它们都有一个直接内置的日志记录系统。

这三条建议只是个开始。如果您想了解更多实现Smartsheet API的高级技巧,请观看下面的ENGAGE ' 18视频会话。我们介绍了如何设置webhook,如何处理API速率限制,如何以编程方式生成访问令牌等等。

订阅智能表资讯科技通讯获取技巧、策略和想法,以帮助IT专业人员提高他们对业务的影响。

相关内容