added note on required API fields and shorted examples to be more readable.