It would be useful if you could specify in api.xml which xins version is required. Example:
<api name="myapi" requires="2.3">...</api>
This way you can ensure that the api is built with the correct version when using functionality that isn't available or buggy in previous versions.