hal-browser
hal-browser copied to clipboard
mikekelly
Hal Browser demo doesn't work
Attempting to use http://haltalk.herokuapp.com/explorer/browser.html doesn't work.
If I just use GET /users, I get an internal server error. Attempting to POST /users to create a new user leads to a 404.
Yep, it needs some love. A heroku upgrade triggered a bunch of library incompatibilities. I did try and fix the dependencies but it was taking too long with no results, I intend to rewrite it if/when I get time.
OK, no problem. Thing is there's not a lot of doc about HAL. Specifically how collections are represented, which is slightly unusual IMO. So I was trying to find some examples. I eventually found some examples elsewhere (apigility I think).
Thanks.
On 17 February 2016 at 17:24 Mike Kelly [email protected] wrote:
Yep, it needs some love. A heroku upgrade triggered a bunch of library incompatibilities. I did try and fix the dependencies but it was taking too long with no results, I intend to rewrite it if/when I get time.
— Reply to this email directly or view it on GitHub https://github.com/mikekelly/hal-browser/issues/77#issuecomment-185311858 .
@tomq42 - have you seen the docs at http://phlyrestfully.readthedocs.org/en/latest/halprimer.html#collections ? Some very useful examples in there of how to model collections in HAL.
Yes, but it was so weird that I don't think I understood it originally. But I think I understand the example a bit better now.
On 18 February 2016 at 10:04 Dylan Beattie [email protected] wrote:
@tomq42 https://github.com/tomq42 - have you seen the docs at http://phlyrestfully.readthedocs.org/en/latest/halprimer.html#collections ? Some very useful examples in there of how to model collections in HAL.
— Reply to this email directly or view it on GitHub https://github.com/mikekelly/hal-browser/issues/77#issuecomment-185635948 .
Hi all. So the rails app is a write-off, it uses a very old database driver. It was something I hacked together in a couple of hours anyway.
I think the best course of action is for someone to create a a new implementation of the hal-talk API. I don't have the bandwidth to do this at the moment. If someone wants to take this on and put it on a public github repo, I'll setup the heroku app so that it auto-deploys from it.
I can dump the existing data, and extract the link relation docs... so if someone does want to take this on let me know and I'll do that
So we're talking about having a small app that implements a few API calls backed by some sort of persistence layer, right? The front-end itself is just (statically served) Javascript, right?
What about the API documentation? That's served (statically) by the backend as well right?
Do you have an opinion on the Tech-stack that will be used?
Not really, preferably something simple and lightweight. Ruby or node.js or similar. It doesn't matter too much to be honest.
I think basically the API just needs some use cases that demonstrates key concepts in a HAL API, ie: traversing links (read, write, delete), embedding resources, etc
I picked "talk" just because it's a relatively simple read/write domain
All right, coming weekend is a busy one for me, so I'll try to make a start next week/weekend. I'll keep you posted.