Versioning

The Yoco API version number is specified in the URL when making an HTTP request.

Here is an example of a request to the v1 API end-point for retrieving a list of orders.

1
curl https://api.yoco.com/v1/orders/ \
2
     -H "Authorization: Bearer <token>"

Breaking changes are never introduced to an existing API version. The version number of the API is always incremented.

What’s a non-breaking change?

• Adding a new API resource.
• Adding a new API end-point.
• Adding a new optional request parameter to an existing API method.
• Adding a new property to an existing API response.
• Changing the order of properties in an existing API response.

What’s a breaking change?

• Removing an API resource.
• Removing an API end-point.
• Removing a request parameter from an API method.
• Changing the behaviour of a request parameter on an API method.
• Adding a new required request parameter to an API method.
• Renaming or re-shaping an API resource, end-point, request parameter or response property.
• Change to the HTTP status code returned from an operation.