rest - 为什么 PayPal Rest API 使用命名空间？

Question

我一直在阅读 PayPal REST API 文档，文档非常详细，对像我这样的初学者很有帮助，我想了解为什么 PayPal REST API 使用命名空间进行资源收集？

1. 他们是否有共同的资源，因此他们使用命名空间来区分？
2. 他们想通过将资源分组到命名空间中使其看起来合乎逻辑？
3. 其他原因？

我非常喜欢 PayPal 如何记录其 REST API 的想法，并想了解更多相关信息。谢谢!!

Answer 1

您肯定提到了很多正确的理由。命名空间是通过将适合通用保护伞的资源组合在一起来表达 API 结构的好方法。如果您查看 API 规范，就会发现在命名空间内共享一些公共(public)对象，这与命名空间的个别要求以及应该公开的内容有关。

我要补充的一个原因是设计良好的命名空间可以帮助 future 验证您的 API 设计，例如如果您看到将来在命名空间下公开更多资源，那么拥有一个是有意义的，即使目前该命名空间下只有一个资源。