具有复合ID的REST API设计

Question

What is the best way to design a RESTful resource for an object with a composite id? For example, suppose I have a GET /people resource for getting a list of person records. A person doesn't have a single id; instead, it is identified by firstName, lastName, and birthdate. How should I design the resource to get a single person?

Answer 1

I would use one of the following variations:

GET /people/John/Smith/1973-12-01

or

GET /people/John,Smith,1973-12-01

Answer 2

正如评论中已经提到的，如果您没有确保唯一性的单个标识符，您可以考虑矩阵变量 ：

GET /people;firstname=John;lastname=Smith;birthday=1973-12-01

Answer 3

关于什么 ：

GET /people/firstName/X/lastName/Y/birthdate/AAAA-MM-DD