Designing REST-URL für Ressource mit mehreren Kennungen

Question

Wenn PUT und DELETE Operationen kann, indem man entweder profileId oder profileName (beide sind einzigartig) auf einer Profil Ressource durchgeführt werden, was ist der richtige Weg, URLs zu bilden?

Ich mag beide unterstützen Update und Operationen auf einer Profil-Ressource löschen, wenn die profileId Senden und unterstützen sowohl Update und Operationen auf einer Profil-Ressource löschen, wenn die profileName senden.

Beim Senden der profileId, die URL für die Durchführung PUT Operationen aussehen würde:

/api/profiles/{profileId} 

Wie würde die URL aussehen, wenn die profileName schicken? Soll der profileName als Abfrageparameter gesendet werden?

/api/profiles?profileName=uniqueProfileName 

Oder gibt es eine bessere Möglichkeit, dieses Szenario zu behandeln?

Answer 1

Sie konnten die profileId als Hauptidentifikator für Ihr Profil Ressourcen nutzen:

/api/profiles/{profileId} 

Und man konnte die {profileName} als sekundäre Kennung unter Verwendung einen Abfrageparameter unterstützt:

/api/profiles?name={profileName} 

Oder ein Matrixparameter:

/api/profiles;name={profileName}