Versioning

The BigOven API strives to provide a consistent customer experience.

Current Version

The current version of the API is available via api2.bigoven.com. For the current version of the API, hereafter the “working version”, all request URLs will be of the form

http://api2.bigoven.com/{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 api.bigoven.com 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 api2.bigoven.com; 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 http://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.