Add a detailed description of IoTAM's API

[dmoranj]

IoTAM's API closely resembles the Provisioning APIs of the IoTAgents, but it's not exactly the same thing. The exact API of the IOTAM should be documented, and the differences with the one IoTA's one highlighted.