Adding a new propety to the API

asked 2014-11-19 00:59:49 -0500

Anil Dongre gravatar image

We are in the process of implementing the openstack API. I wanted a confirmation for one of my understanding and had a few related questions.

  1. If I want to add some new capability to the API not in the OpenStack specification, is extensions mechanism the way to go? For ex. to add a new resource or add an operation to the existing API. Please confirm.
  2. If for example one of the existing API does not have a property that my API implementation expects how do I handle it? If yes, should I still be using extensions for this and have clients always discover my extensions first? Is it an accepted behavior to provide an error message informing clients about why the call failed and how to discover extensions?
  3. Does the use of metadata suit better for point 2 above?
edit retag flag offensive close merge delete