I just finished writing a short tutorial for the Things API. You can get it on my wiki:
otherwise.relics.co.za or from the CVS on the official website.
The tarball contains a PDF, an SVG file and a bunch of python files. You will still need to fetch the actual API and make a link to it where you want to run the tutorial samples.
It should all make a kind of sense. If it does not, then you need to panic! Run around yelling! Or something.
Have fun with Things.