While developing our product we always make changes in Web API.
As soon as our API is used by third parties we understand, that changing API methods brings them risks of getting errors.
As a result we always try to leave our public API back compatible.
But sometimes we have to make major changes in order to increase system's security or changing some base features.
In order to keep our and third party's systems safe, a versioning system is involved: the system requesting API can choose whether to get old or new behavior.
version is a group of numbers which determines API behavior.
Dashly follows semantic versioning scheme.
Full version example:
As minor and patch versions are back compatible we describe only major version changes in our public API.
When you perform an API request, you can set only version prefix in order to use the latest subversion.
Imagine, API has versions
If you set version
2 then full version will be
If you set
1, you will use
You can set version in two ways:
v2 at the URL path)
Important! If you skip settings version, API uses current active API version.
Current active API version (used by default):
Introduces JWT-token auth. All API method, generating authentication tokens
now return a dictionary containing
refresh_token fields instead of string tokens.
Changed pagination scheme.
Initial API version.