问公开用于异步系统的公共API

EN

有一些很好理解的模式用于在HTTP上公开长期运行的异步操作.如何进行这一工作将取决于您的具体需求，以下是一些注意事项：

1. 短轮询。在这种模式中，您有一个"start“HTTP，它返回HTTP 202和异步操作的唯一标识符。然后，您有一个“查询”HTTP，它接受该唯一标识符，并使用操作状态进行响应。这取决于调用方决定调用“查询”API的频率，但是一般来说，异步操作完成和调用者发现它的那一刻之间会有一个滞后。这种模式的一个例子是AWS的Cloud日志、Insigts、StartQuery和GetQueryResults API。
2. 长轮询。在这种模式中，“查询”HTTP是一个HTTP长轮询，这意味着服务器将一直打开它，直到操作完成，或者最长时间已经过去(通常少于45秒)。如果HTTP长轮询在异步操作完成之前返回，则调用方将立即发出新的“查询”操作。对于您来说，这种模式通常实现起来更复杂，资源更密集(保持TCP连接打开)，但会降低调用方发现操作竞争的延迟。
3. Websockets.在此模式中，调用方创建一个持久的web钩子连接，以启动异步操作并等待其完成。这提供了通知调用方完成任务的最低延迟，但超出了常规HTTP的RPC语义的“面包和黄油”，因此在调用方需要更复杂一些。
4. Webhooks.有些系统选择公开webhooks，以通知客户异步发生的重要事件。根据异步操作的持续时间，这可能是正确的模式。例如，条纹经常使用钩子。通知客户支付状态的变化。

除了异步操作的处理之外，在从您的系统公开HTTP时还有许多其他注意事项还具有帮助人们与应用程序集成的想法。