Moving The Philosophy Into Machinery
- Saturday, March 03, 2012
The Alt.Tekpub site is coming together... all the pieces are starting to play nicely. But I still don't have an API. I have an *idea* what I want to do - but I'm waiting on a few more opinions.
I admire people who stick their neck out and offer to help others. In my case, with this whole REST kerfuffle - that would be Glenn Block (aka "2Cs"). He has been patient and kind and I very much appreciate it.
I'm also stubborn. Like you. I do see the merits in understanding concept and theory - but until it's road-tested and battle-hardened it's still just that: vaporous theory that sounds good in the lips, reads well on the blog, falls to pieces in reality.
Please note, once again: I am no stranger to RESTful design and I'm not asking for a tutorial (despite advice so freely given).
What I am Asking For
I would like to invite the good people who have engaged with me over the last few days to jump in and write me up an API - and by way of explanation - show how their ideas can be translated into reality. I have a pretty solid idea of what I want to do for Alt.Tekpub's API signature - but before I lay it out there I would like to see what "those in the know" suggest.
Specifically: I would love some comments (in the form of URLs) from:
I promise the discussion will remain civil (I'mwieldingthe ban hammer - even on myself!).
Here are your Use Cases - they're simple and straightforward. I realize your time is valuable, but I think the readers here would enjoy seeing how you put things together given your deep knowledge.
This is step one: simple authentication and then consumption of basic data. The client will be HTML, JS, and Mobile.
- Logging In. Customer comes to the app and logs in with email and password. A token is returned by the server upon successful authentication and a message is also received (like "thanks for logging in").
- Episodes. Kelly User watches our stuff on her way to work every day, and when she gets on the train will check and see if we've pushed any new episodes recently. A list of 5 episodes comes up - she chooses one, and watches it on her commute.
OK - that's it! What I would specifically love is less guidance and postulation, more URLs.Thanks so much for your time - hopefully this will be a good learning experience for all.