java - REST API命名问题请教

Question

雇员类

public User{
    int id;//key
    int code;//员工编号 唯一
    String name;
    ...
}

api

1. GET /employee/{id} 根据ID获取人员

2. GET /employee/{code}

如上：code也是唯一的，如果这么命名是会混淆，应该如何命名？

Answer 1

/employee/code/{code}

Answer 2

유일한 사용자를 얻는 것은 /employee/{id}입니다. 이 URL을 통해 얻어야 하는 것은 사용자 엔터티 객체입니다.
엔티티 개체 내부 속성의 경우: code URL을 노출하여 가져오면 안 됩니다.

RESTURL을 설계할 때 첫 번째 단계는 리소스 추상화입니다. 어떤 리소스를 추출할 수 있는지 명확하게 구분하고 고유한 URL을 설계해야 합니다. 허용되지 않는 것

Answer 3

RESTful 리소스는 일반적으로 복수형을 사용합니다. 코드도 검색 조건으로 사용할 수 있다고 생각합니다: /employees/search?code=xxx 물론 코드를 직원의 리소스로 얻어서 변경할 수도 있지만, 코드를 통해 직원은 검색 기능에 속해야 합니다.