Asana Webhooks API

Question

因此，我实现了Asana Webhooks API，正如他们的文档所描述的那样。我可以传递给它一个项目ID，并请求创建一个新的web钩子。API成功地向我的应用程序发送了一个身份验证请求，该应用程序返回了Docs中描述的安全头。Asana然后返回预期的成功响应，概述新创建的Webhooks惟一ID。

现在，如果我接受这个ID，然后查询Asana API，直接在父工作区或项目资源上显示所有配置的web钩子，它会返回一个空数据JSON对象，或者报告资源不存在，这表明我刚刚创建的Web钩子并没有被实际创建，尽管给出了预期的成功响应。

另外，如果我对一个项目进行了更改，它就不会触发web钩子，也不会在我的应用程序上收到任何事件。

奇怪的是，星期五一切正常，但今天(星期一)我正在经历这些问题。

任何指针都是好的，我一直按照Docs的建议在请求结构方面工作，并且使用PAT进行身份验证，我甚至尝试了一个新创建的令牌。

谢谢,

Answer 1

我们的webhooks使用握手机制来确保可以回电话给您，但是后面的请求总是有可能失败的。此外(虽然我们没有很好地记录这一点--这是我们的一个机会)，我们应该立即尝试在握手后(看起来像{"events":[]} )传递一个(可能)空事件。这有点像“第二个回调”，其中包含了自创建web钩子以来所发生的任何变化。

如果失败--或者任何后续请求经常失败--web钩子就会被破坏。此上下文中的"Failure“意味着返回HTTP响应代码( 200或204 )。

至于为什么您在查询web钩子本身时有困难，我无法复制这个问题，所以我们必须深入研究。如果你：

• 指定工作区
• 可选地指定资源

我测试了一下，看上去很好。您还可能希望使用/webhooks/:id端点直接查询web钩子by id -注意使用create返回的web钩子的id，而不是resource字段中的id。

如果您创建了web钩子(具体来说，您的PAT或OAuth应用程序就是发出创建请求的应用程序)，那么您应该能够很好地看到这些信息。如果您可以通过id获取web钩子，您应该看到last_failure_at和last_failure_content字段，这将告诉您为什么web钩子无法进行传递。

最后，如果您想在api-support@asana.com与我们联系并让他们知道更多的细节(例如，您试图查看的web钩子的ID )，我们可以从我们这边查看这些字段，看看我们是否能够识别正在发生的事情。