added some docs on API usage