Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

NuGet V3 API service index version moving to 3.0.0 #21

Open
anangaur opened this issue Feb 5, 2018 · 0 comments
Open

NuGet V3 API service index version moving to 3.0.0 #21

anangaur opened this issue Feb 5, 2018 · 0 comments

Comments

@anangaur
Copy link
Member

anangaur commented Feb 5, 2018

Spec wiki Discussion issue
None NuGet/NuGetGallery#5403

For over two years, the NuGet V3 API’s service index has had the schema version of 3.0.0-beta.1. During that period, there were no breaking changes made to the service index schema. Because of this, we will be changing the schema version declared in the document to be 3.0.0. The NuGet team has verified that the official NuGet client and client APIs (e.g. NuGet.Protocol package) properly handle this version change. To test your client implementation against the new version string, you can try NuGet’s staging environment service index: https://apiint.nugettest.org/v3/index.json.

The schema of the service index is defined here in our API documentation:
https://docs.microsoft.com/en-us/nuget/api/service-index

As mentioned in the document, non-breaking changes to the schema can be introduced and will be signaled by a minor version change in the existing document (no change of URL). For example, the version change could change to 3.1.0. These changes of course will be announced through this Announcements repository in advance.

Any future breaking changes will not be made to the existing V3 service index. They would be introduced in a different service index URL.

Third-party server implementations are encouraged to update their service indexes to move from 3.0.0-beta.1 to 3.0.0.

As always, the URL for nuget.org’s production V3 service index is here: https://api.nuget.org/v3/index.json

@NuGet NuGet locked and limited conversation to collaborators Feb 5, 2018
@anangaur anangaur changed the title NuGet V3 API service index moving to 3.0.0 NuGet V3 API service index version moving to 3.0.0 Feb 5, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

1 participant