Click & Drop API specification file improvements
The API specification file can be used to generate programming stubs in several languages.
Location: https://api.parcel.royalmail.com/doc/v1/click-and-drop-api-v1.yaml
These are some update suggestions. I believe, they might make it easier for programmers to work with the API.
(1) Update the minor version number.
info:
version: 1.0.0
This is always the same. I would appreciate it if the number increases when there is a change. This makes it easier to check for compatibility.
E.g. for the Python package, I would like to document compatibility clearly via version number and and not via a date of update. https://niccokunzmann.github.io/python-royal-mail-click-and-drop-api/
(2) host
host: api.parcel.royalmail.com
This field can be set. It would be very useful for anyone who generates the code files for the API. This is probably the only host that matters.
Thank you.