It uses JSON-HAL (https://tools.ietf.org/html/draft-kelly-json-hal-08) to represent link relationships, which seems as sane as any proposal to me, but I'm not up on the state of the art and don't consider myself an authority.
I would encourage others to weigh in on that PR if you're interested.