REST API 中的正确寻址 [关闭]

Question

我创建了一个应用程序，您可以在其中提问和回答。关于如何创建地址以添加对问题答案的评估的决定，我有一个小问题。

我有两个想法

POST http://localhost:8080/answers/{answerId}/votes

或

POST http://localhost:8080/questions/{questionId}/answers/{answerId}/votes

在我看来，第一个地址更合适，因为在网站上我将能够得到答案

AnswerEntity answerEntity = this.answerRepository.getById(answerId);
answerEntity.setVotes(...);

但是，第二个地址的服务看起来像这样

QuestionEntity questionEntity = this.questionRepository.getById(questionId);
for(AnswerEntity answer : questionEntity .getAnswers()) {
     if(answer.getId().equals(answerId) [
          answerEntity = answer;
     }
}
answerEntity.setVotes(...);

因此，在我看来，第一个地址更好，但我想就这个问题征求您的意见。根据 REST API，第一个地址的语法是否正确？

Answer 1

这两种路径都对 REST API 有效，但它们具有不同的语义。

第一个路径/answers/{answerId}/votes 应该允许访问系统中任意答案的投票，只需使用唯一答案 ID 作为参考即可。这里没有问题上下文。

第二条路径/questions/{questionId}/answers/{answerId}/votes 限制了可在 URL 中使用的有效答案 ID 集，因为该路径的开头将上下文缩小到特定问题。那么只有针对该特定问题的答案 ID 才可以请求相应的投票。

所以这取决于您想为您的消费者提供什么，即最适合您的消费者需求的东西。