I want to learn more about Hypermedia APIs. Does anyone know of any pragmatic resources?
-
Show this thread
-
Went for a bit of a search, and found some interesting resources: - https://robots.thoughtbot.com/writing-a-hypermedia-api-client-in-ruby … - https://github.com/hjr3/hal-rs/
1 reply 1 retweet 1 likeShow this thread -
Been doing some more reading, and have some more thoughts: - Hypermedia APIs are cool because they allow people to *explore* data without needing to refer to any specs, dynamically. - OpenAPI definitions are cool because they allow generating specs & clients, statically.
1 reply 0 retweets 0 likesShow this thread -
What I wonder is if we could apply both to an API! I reckon it would be cool because: - We could present an interactive "explorer" page that allows you to interact with the API before writing any code. - We could generate API specs & clients for when you want to write code.
1 reply 0 retweets 1 likeShow this thread -
I'm probably missing a few benefits, still -- but this is as far as I've come this morning, and I think it presents a reasonable picture on what a resulting REST API could look like. I'd love it if services had both static docs, and interactive explorers! Reckon it'd be fun! :D
1 reply 0 retweets 2 likesShow this thread
Anyway, this is as far as I'll be taking this exploration today. Thanks for tuning in!
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.