服务器和Web应用程序之间的API

Question

我有一台服务器在另一台机器上运行，另一台服务器上运行Web应用程序。 我需要服务器将事件信息传递到Web应用程序以在浏览器上显示

我们目前有一个机制，在这个方向传递信息。该Web应用程序收到以JSON格式化的Map<String,String>。

我的问题是服务器应该如何解释这些字符串。 双方都需要知道字符串是什么意思，但是我应该在每一边都有重复的定义。 这似乎不是个好主意......

我如何定义的消息的格式，并在一个共同的地方的代码，最好是不依赖于任何实现或语言

我没有能够找到关于这个主题的信息，请发送链接到相关的网页（如果你知道的话）

我也会很高兴听到推荐为良好的API设计和实现资源

Answer 1

如果服务器是用相同的语言编写的，那么确定你可以设置一个通用的代码库来使用它双方的数据结构相同。只要意识到这些数据结构的责任实际上可能会因为其包含的服务器的性质而大不相同，尽管它们代表了相同的概念模型。例如后端服务器将执行诸如与数据库交互和执行安全检查等操作，而前端可能正在验证用户输入和格式化消息。无论如何，这并不总是一件好事。

如果语言不一样，您可能需要单独对它们进行编码。你也可以尝试从一种语言到另一种语言进行交叉编译，或者选择某种可以编译为目标语言的格式，但这是过度的。

这是分布式（又称微服务）体系结构与整体结构之间的折中之一。好处是每个服务都更小，更敏捷。缺点是可能会导致重复工作。没有正确的答案。