added some examples to api