URL命名约定，仅从资源中获取列

Question

我有一个微服务端点，该端点从数据库获取公司详细信息列表。 URL模式如下所示。

获取https://example.com/api/v1/companies

我需要开发另一个URL，该URL仅从DB中获取公司名称。我知道我可以重复使用相同的URL，但是只获取一列，我不想获取所有列。

在这种情况下，请指导我如何使用网址格式。

例如：获取https://example.com/api/v1/companies/companyNames吗？

Answer 1

我们不应该增加真正需要的服务数量。我建议重新使用格式相同的服务：

获取https://example.com/api/v1/companies?col=name

如果col参数为空，则可以假定返回所有列。这将帮助您重用代码库。最小的变化；以及将来的灵活性并减少了最终用户的困惑。