Versioning

The BigOven Build API strives to provide a consistent customer experience.

Current Version

The current version of the API is available via https://bigoven-api2-shadow.azurewebsites.net. For the current version of the API, hereafter the “working version”, all request URLs will be of the form

https://bigoven-api2-shadow.azurewebsites.net/{query}

By targeting the working version, the consumer understands that future API Changes may cause an implementation to operate in a different manner than originally intended. It is the responsibility of the consumer to synchronize with API Changes. We do make every effort to preserve compatibility of endpoints; major new releases are delivered via new hostnames.

The endpoint https://bigoven-api-shadow.azurewebsites.net uses our v1.0 protocol and is no longer the preferred version. We have made several improvements and breaking changes to that endpoint. We recommend new developers start with https://bigoven-api2-shadow.azurewebsites.net; support for api.bigoven.com will continue through at least the end of this calendar year.

We strongly recommend targeting the current version of the API at https://api2.bigoven.com

Lifespan of a Version

While the consumer can expect a specific version of the API to be available for a considerable period of time, BigOven reserves the right to discontinue support for any historical version of the API with six (6) months of advance warning.