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のようにコードを検索条件として使用することもできると思いますが、従業員のリソースとしてコードを取得および変更することもできます。コードを通じて、それは検索関数に属している必要があります。