mboost-dp1
“Beautiful REST + JSON APIs” by Les Hazlewood
God læsning. Jeg er dog ikke helt med på hvordan og hvorfor han skifter ID ud med et href?
Koden der implenterer APIet kender jo i forvejen URLen og vi kan vel også godt gå ud fra det kender de objekter der kan bruges (i hans tilfælde accounts)
Så hvorfor:
{
"href": "https://api.foo.com/v1/accounts/a11b223",
"givenName": "Tony",
"surname": "Stark",
istedet for
{
"id": "a11b223",
"givenName": "Tony",
"surname": "Stark",
Koden der implenterer APIet kender jo i forvejen URLen og vi kan vel også godt gå ud fra det kender de objekter der kan bruges (i hans tilfælde accounts)
Så hvorfor:
{
"href": "https://api.foo.com/v1/accounts/a11b223",
"givenName": "Tony",
"surname": "Stark",
istedet for
{
"id": "a11b223",
"givenName": "Tony",
"surname": "Stark",
#2
Fordi det href er en mere korrekt repræsentation af det dokument du bliver præsenteret for. Det indeholder, ud over hvilket id resourcen har, også information om hvor dokumentet kan tilgåes.
Specielt er det brugbart i det tilfælde hvor der er flere forskellige versioner af et API tilstede. "href" peger her på resourcen, som den bliver repræsenteret vha. v1 api'en.
Det er ikke garanteret at v2 api'en vil repæsentere dataene på samme måde.
Så, jeg ville også foretrække en href fremfor et id.
Fordi det href er en mere korrekt repræsentation af det dokument du bliver præsenteret for. Det indeholder, ud over hvilket id resourcen har, også information om hvor dokumentet kan tilgåes.
Specielt er det brugbart i det tilfælde hvor der er flere forskellige versioner af et API tilstede. "href" peger her på resourcen, som den bliver repræsenteret vha. v1 api'en.
Det er ikke garanteret at v2 api'en vil repæsentere dataene på samme måde.
Så, jeg ville også foretrække en href fremfor et id.
Opret dig som bruger i dag
Det er gratis, og du binder dig ikke til noget.
Når du er oprettet som bruger, får du adgang til en lang række af sidens andre muligheder, såsom at udforme siden efter eget ønske og deltage i diskussionerne.
- Forside
- ⟨
- Forum
- ⟨
- Tagwall
Gå til bund