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

Obtenir le seul utilisateur est /employee/{id} Ce que vous devriez obtenir via cette URL est l'objet entité utilisateur.
Pour les propriétés à l'intérieur de l'objet entité : code Ne doit pas être obtenu en exposant l'URL.

La première étape lors de la conception de RESTURL est l'abstraction des ressources. Il est nécessaire de distinguer clairement quelles ressources peuvent être extraites et de concevoir une URL unique. Ce qui n'est pas autorisé

Answer 3

Les ressources RESTful utilisent généralement des nombres pluriels. Je pense que le code peut également être utilisé comme condition de recherche : /employees/search?code=xxx Bien sûr, le code peut également être obtenu et modifié en tant que ressource d'employé, mais pour le trouver. les employés via le code doivent appartenir à la fonction de recherche.