[Openid-specs-ab] FYI: Being RESTful with JSON API -- HAL+JSON

Nat Sakimura sakimura at gmail.com
Mon Aug 27 16:00:22 UTC 2012

Yes, I think I have seen (not read in detail) the old version of
JSON-Schema a while ago.
Maybe I should look at them again.

HAL is easier to grasp, though, at least on the surface.


On Mon, Aug 27, 2012 at 10:05 PM, Pat Cappelaere <pat at cappelaere.com> wrote:
> Nat,
> Have you looked at JSON-Schema and Hyper Meta-Schema? http://json-schema.org/
> [But I do like HAL links better… but there is a reason why they have been stored in an array…]
> Pat.
> On Aug 27, 2012, at 8:57 AM, Nat Sakimura <sakimura at gmail.com> wrote:
>> I was not aware of HAL. http://tools.ietf.org/html/draft-kelly-json-hal-03
>> As you know, since JSON has no defined link relation syntax, by
>> itself, a JSON API is not quite RESTful.
>> See http://norestforjson.blogspot.jp/2012/08/json-is-not-restful.html
>> There are people who is working to define such. One example is HAL.
>> - http://tools.ietf.org/html/draft-kelly-json-hal-03
>> Interestingly, our Userinfo response is almost like HAL: if we replace
>> _claim_sources to _link and
>> mandate there be "self" in it, and response type was changed to
>> application/hal+json instead of application/json, then it is HAL.
>> Interesting?
>> --
>> Nat Sakimura (=nat)
>> Chairman, OpenID Foundation
>> http://nat.sakimura.org/
>> @_nat_en
>> _______________________________________________
>> Openid-specs-ab mailing list
>> Openid-specs-ab at lists.openid.net
>> http://lists.openid.net/mailman/listinfo/openid-specs-ab

Nat Sakimura (=nat)
Chairman, OpenID Foundation

More information about the Openid-specs-ab mailing list