This is a very interesting discussion to me. I'm still on the fence about the idea of putting links in API formats. For HTML that works of course, because we understand contexts and meanings. Usually. But libraries have a harder time doing this and semantics only goes so far.

Another short term problem I would see is adoption of this on the API provider side. That's of course something a well coordinated initiative would take care of.

I'm looking forward to seeing where this goes and learning more about it.