index
API OVERVIEW
AUTHENTICATION
API PROTOCOL
API DATA
- Recipes
- Recipe Reviews
- Recipe Images
- Recipe Search Results
- Food Glossary
- Favorites
- Try Soons
- Grocery List
- User Profile
DATA MANAGEMENT
BRANDING, LEGAL & FINANCIAL
Versioning
The BigOven API strives to provide a consistent consumer experience. To this end, a versioning scheme has been designed to address future changes in the API.
Current Version
For the current version of the API, hereafter the “working version”, all request URLs will be of the form
http://api.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.
Targeting a Version
For consumers that are unable or unwilling to update an implementation in a consistent manner, a particular version of the API may be specified in each request. Requests of this type will take the form
http://api.bigoven.com/v{#}/{query}
where v{#} could be v1, v2, v3, etc.
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.
