Api docset / reference

Is there an API doc set available which includes details such as platform conventions, common utility methods, capabilities, restrictions, minimal examples.

I am completely lost at what I can and cannot do. a minimal API reference would go a long way.