Write FAQ page about API

[nfagerlund]

Suggested here. Seems like a good idea! This probably shouldn't be the "real" API docs, but since people would look for this sort of thing in the faq, it can at least give a rough idea of what's possible and link out.