So, I am just about writing something that would describe my REST API (possibly generate handlers from description) and integrate very nicely with Sphinx for docs, and I can see (on slides) you already have something like that. Am I right? Do you plan to share something like that? Thanks.
Re:We're doing HTTP right
by the_mitsuhiko on Monday May 28, 2012 @05:59PM
(#4035096)
Yes, we have something for that but it's customized for our type system. But I think I could probably write.something up about Sphinx customization.
the original article isn't fresh in my mind anymore, but I enjoyed this one and found myself agreeing more. :)
FWIW, my opinion is it is very similar to how things are done on appengine. You want to schedule a task? you make a form post to an end point thats setup to be monitored by their service. you want to talk to a backend instance? post to it. maybe their rpcs work the same way (serialize to protocol buffer, post to endpoint, get response, deserialize protocol buffer).
it feels low tech and un-sexy, but it works and it's easy to understand.
I since pulled that and rewrote it to better show what our infrastructure is actually like.
I'm more than happy to answer questions about that :-)