Domanda di progettazione REST più identificativi per una risorsa che deve essere esposta ai client

Question

Vorrei fare una domanda di progettazione su un'API HTTP REST che sto esponendo.

devo accedere a volte un widget con ID 3:

http://ourserver/service/widgets/3

widget con ID 3

Ma ho anche bisogno di accedere a volte un widget da esso è SKU #.

È errato esporre la stessa risorsa tramite 2 URL?

BUt Ho bisogno che i miei clienti ottengano un widget dal suo ID o dal suo SKU.

Quale delle seguenti opzioni è migliore?

• http://ourserver/service/widgets/bysku/skyunumber
• http://ourserver/service/widgets/skyunumber?idtype=sku

Ancora una volta a ripetere, ho bisogno i miei clienti per essere in grado di cercare un widget in 2 modi diversi. Qual è il modo migliore per progettare gli URL?

Answer 1

vorrei suggerire considerare quanto segue:

GET http://ourserver/service/widgets?sku=34342323 
=> 
303 See Other 
Location: http://ourserver/service/widgets/43 

GET http://ourserver/service/widgets/43 

Utilizzando un reindirizzamento, è possibile supportare qualsiasi numero di criteri per trovare i widget. Il problema chiave da considerare è che cosa succede quando si inizia a abilitare la memorizzazione nella cache. Se si restituiscono rappresentazioni da più URL si finisce per inquinare la cache con più copie e rende molto più difficile invalidare le copie nella cache quando si eseguono gli aggiornamenti.