我目前正在评估框架“wolkenkit”[1]，以便在应用程序中使用它。在这个应用程序中，我将拥有一个用于基于租户的数据管理的用户界面。只有经过身份验证的用户才能访问此应用程序。
此外，还应该有一个公共 REST API 遵循通用标准并可由公众调用（租户安全性通过在请求标头中提交基于租户的 API 密钥来完成）。
据我所知，wolkenkit REST API 似乎不符合这些 HTTP 动词形式的标准。
但是由于 wolkenkit 在我看来是一个非常灵活且易于使用的框架，我想知道如何基本上实现这样一个公共 API。 可能是例如创建内部连接到 wolkenkit 后端的自己的 Web 应用程序的有效方法？那么额外的性能开销呢？
【问题讨论】：
除了mattwagl 的answer，我想指出一些你可能感兴趣的事情。
首先，由于wolkenkit是基于CQRS，所以应用程序有一个单独的读写API。这意味着，如果您发送一个命令（其目的是更改状态），它将转到 write API。如果您订阅事件或运行查询，则会转到读取 API。
这再次意味着，如果您发送命令，则由写入方来响应它。由于写端并不意味着返回应用程序状态，它基本上只是说：“谢谢，我收到了命令。”要获得实际结果，您必须等待适当的事件，这意味着订阅读取 API。
在wolkenkit documentation 中有一个很好的图表，清楚地显示了这一点：
如果您现在添加一个单独的 REST API（它实际上满足了 REST 的要求），这意味着您需要在内部处理等待结果。换句话说：wolkenkit 中的客户端始终是异步的，而 REST 不是。因此，您的工作是在 REST API 中处理 wolkenkit API 的异步行为。我认为这是最难的部分。
完成此操作后，您将拥有一个同步 REST API，当然它会有一些开销。但我认为由于它的开销仅限于传递和翻译网络请求，应该可以忽略不计。
哦，最后，您还需要注意另一件事：由于 REST 最初的含义是依赖 HTTP 动词来传输语义，因此您需要将 GET / POST / PUT / DELETE 映射到语义wolkenkit 的命令。只要这可以 1:1 完成，一切都很好 - 当有多个命令（从技术上讲）执行 UPDATE 时，问题就开始了。
PS：我也是wolkenkit的开发者之一。
PPS：无论您打算解决这个问题，我都非常有兴趣收到您的来信！如果您能与我们分享您的经验，那就太好了，因为您很可能不是最后一个有这个想法的人。如果您想联系我们，最简单的方法是通过Slack。
【讨论】：
可以使用 HTTP 和 Websocket-API 访问 wolkenkit 应用程序。这些 API 均由 wolkenkit 在后台使用的 tailwind 模块提供。在 tailwind 存储库中，您可以找到可用 HTTP 路由的a very simple documentation。
你说得对，wolkenkit HTTP-API 不是经典的 REST-API。它更像是 RPC 风格，根据我们的经验，它非常适合应用程序。您的客户/租户只需要支持 3 条路由：/v1/command (POST) 用于发出命令。您发布的命令应遵循the command schema。 /v1/events (POST) 可用于将事件流式传输到客户端。这些事件将遵循the event schema。最后你有/v1/read/:modelType/:modelName (POST) 来读取模型。你可以简单地use HTTPie to test these routes。
这些 API 的身份验证当前使用 OpenID-Connect 完成。 a very detailed article 介绍了如何使用 Auth0 设置身份验证。我不太确定这是否适合您的用例，但您基本上可以使用任何遵循此标准或能够发出 JWT 令牌的身份验证服务。
最后，您还可以通过构建一个在底层使用wolkenkit-client-js 的模块来构建您自己的在浏览器中运行的 JavaScript 客户端 SDK。此 SDK 可以只使用 same API as any other client 连接到您的应用程序。
希望这会有所帮助。
PS：请注意我是wolkenkit的作者之一。
【讨论】：