패키지 세부 정보 URL 템플릿

클라이언트는 사용자가 웹 브라우저에서 더 많은 패키지 세부 정보를 확인하는 데 사용할 수 있는 URL을 빌드할 수 있습니다. 이는 패키지 원본이 NuGet 클라이언트 애플리케이션이 표시하는 범위 내에 맞지 않을 수 있는 패키지에 대한 추가 정보를 표시하려는 경우에 유용합니다.

이 URL을 빌드하는 데 사용되는 리소스는 서비스 인덱스에서 찾은 리소스입니다PackageDetailsUriTemplate.

버전 관리

다음 @type 값이 사용됩니다.

URL 템플릿

다음 API의 URL은 afore멘션ed 리소스 @type 값 중 하나와 연결된 속성의 값입니다@id.

HTTP 메서드

클라이언트가 사용자를 대신하여 패키지 세부 정보 URL을 요청하지는 않지만 웹 페이지는 웹 브라우저에서 클릭된 URL을 쉽게 열 수 있도록 메서드를 지원 GET 해야 합니다.

URL 생성

알려진 패키지 ID 및 버전이 지정된 경우 클라이언트 구현은 웹 인터페이스에 액세스하는 데 사용되는 URL을 생성할 수 있습니다. 클라이언트 구현은 생성된 URL(또는 클릭 가능한 링크)을 사용자에게 표시하여 웹 브라우저를 URL로 열고 패키지에 대해 자세히 알아볼 수 있도록 해야 합니다. 패키지 세부 정보 페이지의 내용은 서버 구현에 의해 결정됩니다.

URL은 절대 URL이어야 하며 스키마(프로토콜)는 HTTPS여야 합니다.

서비스 인덱스의 @id 값은 다음 자리 표시자 토큰을 포함하는 URL 문자열입니다.

URL 자리 표시자

서버는 대/소문자를 사용하여 값을 수락 {id}{version} 해야 합니다. 또한 서버는 버전 이 정규화되었는지 여부에 민감하지 않아야 합니다. 즉, 서버는 정규화되지 않은 버전도 수락해야 합니다.

예를 들어 nuget.org의 패키지 세부 정보 템플릿은 다음과 같습니다.

https://www.nuget.org/packages/{id}/{version}

클라이언트 구현에서 NuGet.Versioning 4.3.0에 대한 패키지 세부 정보에 대한 링크를 표시해야 하는 경우 다음 URL을 생성하여 사용자에게 제공합니다.

https://www.nuget.org/packages/NuGet.Versioning/4.3.0