Describe in details API for requesting all Platforms

[dzahariev]

Operation that returns all registered platforms is missing in SM Control API. Add this operation to specification with all required details:

• Request syntax
  • Parameters
  • Payload (if any)
• Response
  • Payload
  • Error codes

[dotchev]

Done with #21