Was ist der richtige Medientyp für HAL + JSON?

Question

Ich verwende Spring, um einen RESTful-Service zu erstellen, und ich bin neugierig auf die Syntax für Medientypen.

Aus meiner Sicht ist der allgemeine Medientyp für HAL + JSON application/hal+json. Aus meiner Sicht ist ein herstellerspezifischer benutzerdefinierter Medientyp, der HAL + JSON unterstützt, etwas wie application/vnd.api.entity.hal+json. Allerdings habe ich auch application/vnd.api.entity+hal+json gesehen. Welches ist korrekt?

Auch was wäre der richtige Wildcard-Typ für HAL + JSON? Wäre es application/*.hal+json oder application/*+hal+json. Links zu allen relevanten RFCs sind willkommen. Vielen Dank!

Answer 1

application/vnd.api.entity+json 

application/vnd.api.entity.hal+json würde nur Sinn machen, wenn Sie planen, auch für HAL ohne Unterstützung Ihre Daten zu liefern. Der Kunde muss die Struktur des Inhalts sowieso kennen und HAL ist Teil davon.

application/vnd.api.entity+hal+json ist einfach falsch. Die standard besagt, dass nur registrierte Suffixe verwendet werden sollten. Sie bezeichnet sie auch als "Strukturierte Syntax Suffixe". Es ist also klar, dass es darum geht, Daten nicht über ihre Bedeutung zu lesen. Nur ein Suffix ist erlaubt und mehr würde keinen Sinn ergeben.

Denken Sie darüber nach, wie application/semantic+syntax oder application/what's in it + how to read it.