Finally knuckled down yesterday and read a very good intro to APIs from Zapier. Brought lots of Half understood bits and pieces together for me. But when I started to play, using the Restlet client in Chrome, I kept getting 403s from my site.
More playing is needed, but probably not today.