In this web content, the author discusses the differences between Hypermedia APIs and Data (JSON) APIs. They argue that tightly coupling a web application to a hypermedia API is a good approach and advocate for splitting a data API and hypermedia API. The author dismisses content negotiation as the right approach for returning both JSON and HTML, explaining that data APIs need to be stable and versioned, while hypermedia APIs can change based on user interface needs. Instead, they propose splitting APIs into separate controllers for better stability and flexibility. The author also mentions the use of content negotiation in Ruby on Rails.
https://htmx.org/essays/why-tend-not-to-use-content-negotiation/