Quali sono gli standard per avere risorse nidificate nell'API REST

-1

Sto progettando un'API REST e ho capito che vedrò come gli altri stanno nominando le loro risorse e scegliendo i percorsi.

Osservo l'API di Twitter e vedo che hanno risorse annidate. Ad esempio:

https://dev.twitter.com/rest/reference/get/statuses/retweets_of_me

La risorsa si chiama retweets_of_me ma è anche annidata sotto statuses .

Questo significa che esiste un'associazione logica tra le due risorse? Posso scegliere qualsiasi percorso che voglio utilizzare, ma le rotte arbitrarie probabilmente non sono una buona pratica.

    
posta That Umbrella Guy 17.09.2014 - 18:06
fonte

1 risposta

2

Uso di percorsi casuali ... cattiva progettazione.

Riguardo alla nidificazione, prendi un caso d'uso in cui hai un insieme di utenti e una serie di libri e un determinato utente può avere più libri associati

Avrebbe quindi senso avere:

  • /users : ottieni utenti, puoi utilizzare parametri di query per l'impaginazione, l'ordinamento e il filtro
  • /books - ottieni libri
  • /users/{user_id}/books : ottieni i libri associati a un determinato utente, avendo quindi un annidamento naturale, riflesso anche dal tuo modello di dati

Questo è stato solo un semplice esempio, sperato in un aiuto, per una migliore comprensione suggerirei google per qualcosa come la ricerca delle migliori pratiche, andare su più fonti e provare ad adattare qualcosa che ti sembra ok e ha anche senso da il punto di vista dei requisiti dell'app

    
risposta data 17.09.2014 - 23:30
fonte

Leggi altre domande sui tag