API设计指南

这篇文章涵盖了我们在PayPal扩展GraphQL时学到的所有知识，并将作为在您的公司中部署GraphQL的指南。一年前，我们撰写了“ 

GraphQL并不是要取代REST，它是固执己见的，并且在设计时考虑了特定的约束。它是一种强大的查询语言，可以让客户端掌控一切。但取决于具体情况，这可能是好的或坏的做法！RESTful API可能难以正确设计。我的意思是那些利用HATEOAS的人。但是一旦你做对了，它就会非常强大。特

本文中的建议适用于任何API。但是，当应用程序使用动态语言（如JavaScript）编写而不是更静态的语言（如Java）时，我们会考虑更容易遇到的一些问题。Node.js有时被称为胶水，它将系统导向的体系结构保持在一起，因为它易于与多个后端服务通信并将结果拼接在一起。出于这些原因，我

我不认为Web开发社区正在就GraphQL 进行诚实的讨论。这是因为，GraphQL几乎作为REST（Representational State Transfer）的完全替代方案。而且，虽然GraphQL可以消除REST中发现的摩擦点，但是当涉及到API实现时，不诚实的根源在于错误和隐含的

使用基本CQRS方法和域驱动设计实现的.NET Core

单个API不足以让开发人员具有创新性。当API一起使用时，API非常强大，因此组合维度才是最重要的.API允许组织大规模地为其合作伙伴提供对数据和功能的访问。可扩展和适应性强的API生态系统使开发人员更容易进行创新。建立这样一个生态系统是一个前进的过程，面临许多技术挑战。AP

1. 我不介意REST与GraphQL的争论，但是如果你看到像“你有过度获取/不足获取（over/under-fetching）的REST”这样的论点，这对REST来说不是问题，那就是糟糕的API设计。辩论需要以真正的问题为中心 就像有人抱怨SQL有一个“over/under-fetchin

我们构建软件的方式正在发生变化。现在，由于API平台的激增，公司将以更快的速度推出市场并以前所未有的速度构建功能。API经济近年来爆炸式增长，数以千计的新API进入市场并重塑了开发人员构建软件的方式。几乎所有需求都有API解决方案：支付API，通信API，运输API以及数千种

使用领域查询替换普通自由查询可以将业务知识从服务器内部分离出来。 问题查询通常与数据库查询相关联。然而，我们可以通过其他方式查询不是数据库的系统，比如查询REST和GraphQL等API。自由查询这个术语是

服务网格是一组重要的功能，可以在运营服务式架构时解决一些困难的服务到服务通信挑战。就像Kubernetes和容器有助于在一组计算机上提供一组很好的抽象来部署和运行工作负载一样，服务网络也出现了抽象网络，使运营商和开发人员能够控制请求路由，可观察性和政策执行。这提供了很多潜力。唯一的问

Rio是一种MicroPaaS，可以在任何标准Kubernetes集群之上进行分层。用户可以轻松地将服务部署到Kubernetes并自动获得持续交付，DNS，HTTPS，路由，监控，自动扩展，canary部署，git触发构建等等。所有这一切只需要Kubernetes集群和rio CLI。

Java非常适合实现业务逻辑，但是在处理数据集时存在一些弱点。这些任务通常与必须处理大量与POJO相关的样板代码并以编程方式更新每个属性有关。在本文中，我们将探讨

API网关可以做很多事情。他们有选择地向更广泛的受众公开私人服务。借助路由规则，它们可以在不通知客户的情况下在服务版本之间移动客户端。它们通过提供速率限制和缓存等功能来保护下游服务。而且，它们为具有微服务架构的用户提供了一种可行的方式来保护服务安全，而无需每个服务都进行自己的身份验证。从历史

Bloom与您的API实现完全无关，并且只需对现有API代码进行最少的更改即可。Bloom使用redis

目的在单个位置聚合调用微服务：API网关。用户只需调用API网关，然后API网关就会调用每个相关的微服务。

有时我们需要做一个很简单的Http Rest API，但是不想使用Spring Boot过重的框架，其依赖包太多，这里展示在在Docker中使用Java运行API端点其实并不需要这些框架，只要一个依赖包就好，非常轻量。 实际上，我们只使用单个库作为