我有一个RESTful API,我正在设计它使用数字主键的所有资源.然而,一种类型的资源具有方便的自然键,我希望能够将其用作指定单个资源的可选方式.为了保持一致性,可以通过主键访问所有资源.
就目前而言,我可以这样做(假设23
是主键):
mysite.com/api/v0/sites/23/
但是,我想知道是否有一种惯用的方法来为资源指定备用自然键.
到目前为止,我一直想做这样的事情:
mysite.com/api/v0/sites/?domain-name=someothersite.com/
因此,单个站点资源可以通过其主键和自然键(其域名)访问.我主要关心的是以惯用的方式进行此操作,因为我希望尽可能简单地使用API.