Documentation?

It the API actually documented anywhere? I have looked around and saw 2 or 3 code examples, but is there any actual documentation? Where is the best place
to look to get an idea of how things work, or am I missing something?

Thanks!