Making the API description more explicit

Separating internal/external API, mentioning JSON and XML-RPC