add more API document
Merge pull request #32 from heinzeya/master

add more API documentation to apiary