Versioning¶
The Yahoo Native API supports both versioning and migrations, so Yahoo Native partners and developers can roll out changes over specific periods of time when integrating with the API.
API versioning has been supported since the initial v1 release of the Yahoo Native API.
v3 API¶
The new v3 Yahoo Native API provides partners with these advantages:
Support for Upgraded URLs (UUs). For more information on Upgraded URLs (UUs) in v3, refer to Upgraded URLs.
Greater API object stability, as well as improved management of API changes, building on the enhancements in v2 Yahoo Native API.
Support for Site X Device Targeting with new available targeting attributes. For more information, refer to Targeting Attributes.
Additional bug and error fixes for improved performance and stability.
v2 API¶
The v2 Yahoo Native API provided partners with a number of advantages:
Improved management of API changes: for example, improved handling of backward-incompatible features
Faster introduction of new feature releases, like the rapid introduction for v2 of a new object type, shared sitelink
Smoother transitions to support older API functionalities, specifying exact dates for deprecation and End of Life (EOL)
Advance Notice for Developers¶
Developers will receive advance notice when the API changes.
What’s New will provide information on new features and changes in release schedules, as needed.
The Partner Support page will also provide you with a quick snapshot of recent and upcoming releases.
Release Schedule¶
The Yahoo Native v3 API was released on 25 July 2017. V2 is still supported post-release. Official deprecation for the v2 API has not yet occurred. Partners and developers will be notified once this has been officially determined, and a schedule provided.
The schedule for the v3 release is shown in the table below, as well as dates for the v1 deprecation.
API version |
Release date |
Deprecation date |
End of Life (EOL) |
Migration path |
---|---|---|---|---|
v3 |
25 July 2017 |
|||
v2 |
1 June 2016 |
|||
v1 |
1 September 2015 |
1 September 2016 |
1 September 2017 |
Migrate to v2 |
Developer Impact¶
If you make a call to the Yahoo Native API without specifying the version, a 404 error will be returned.
All breaking changes will be rolled into the new version. Support for multiple versions of the API is still maintained, even if different versions provide different levels of functionality.
v3 Endpoints¶
v3 endpoints will be versioned as part of the URL, shown below:
Resource URI
https://api.gemini.yahoo.com/v3/rest/{resource}
All the endpoints in the Yahoo Native API have been updated to v3. The v2 version of the API is still available by clicking on the links in this documentation table of contents.
Version Numbering System¶
The new version numbers are for major releases of the Verizon Media API. There will be no minor versions released because non-breaking changes will be rolled into the current version.