rest - 名称或 ID 作为 restful api 的 url

Question

我目前构建了一个带有users 路由的restful api。如果用户名是唯一的，使用用户名或他的 id 作为参数是否更愚蠢？

要么

example.com/api/users/johndoe

或

example.com/api/users/123456

此外，我还为一个project 资源规划了路线。如果我在这里需要项目 ID，会不会是一个不一致的设计？

Answer 1

通常用户名更容易记住，但我建议您使用 ID，因为在用户名中可能有空格或其他字符(例如德语元音变音)，这些字符很难形成良好的 url 格式。也可能是用户更改了他的名字。那么所有链接都将与 ID 相对无效。