Qual è il tipo di supporto corretto per HAL + JSON?

Question

Sto usando Spring per creare un servizio RESTful e sono curioso della sintassi per i tipi di media.

Dalla mia comprensione, il tipo di supporto generale per HAL + JSON è application/hal+json. Inoltre, dalla mia comprensione, un tipo di media personalizzato specifico del fornitore che supporti HAL + JSON sarebbe qualcosa come application/vnd.api.entity.hal+json. Tuttavia, ho anche visto application/vnd.api.entity+hal+json. Quale è corretto?

Inoltre, quale sarebbe il tipo di wild card corretto per HAL + JSON? Sarebbe application/*.hal+json o application/*+hal+json. I collegamenti a qualsiasi RFC pertinente sarebbero apprezzati. Grazie!

Answer 1

application/vnd.api.entity+json 

application/vnd.api.entity.hal+json avrebbe senso solo se si prevede di fornire i dati anche senza il supporto per HAL. Il cliente deve comunque conoscere la struttura del contenuto e HAL ne fa parte.

application/vnd.api.entity+hal+json è semplicemente sbagliato. Lo standard afferma che devono essere utilizzati solo suffissi registrati. Si riferisce anche a loro come "Suffissi della sintassi strutturata". Quindi è abbastanza chiaro che si tratta di come leggere i dati non sul suo significato. È consentito un solo suffisso e altri non avrebbero senso.

Pensateci come application/semantic+syntax o application/what's in it + how to read it.