추가 정보 Uri 템플릿
클라이언트는 특정 패키지에 대한 추가 정보를 다운로드하는 데 사용할 수 있는 URL을 빌드할 수 있습니다. 이렇게 하면 클라이언트가 전체 패키지를 다운로드하지 않고 패키지의 추가 정보 렌더링을 수행할 수 있습니다.
이 URL을 빌드하는 데 사용되는 리소스는 서비스 인덱스있는 ReadmeUriTemplate 리소스입니다.
버전 관리
다음 @type 값이 사용됩니다.
| @type 값 | 노트 |
|---|---|
| ReadmeUriTemplate/6.13.0 | 초기 릴리스 |
URL 템플릿
다음 API의 URL은 앞에서 언급한 리소스 @type 값 중 하나와 연결된 @id 속성의 값입니다.
HTTP 메서드
생성된 URL은 HTTP 메서드 GET 지원해야 합니다.
URL 생성
알려진 패키지 ID 및 버전이 지정된 경우 클라이언트 구현은 추가 정보 다운로드 URL을 생성할 수 있습니다.
@id 값은 다음 자리 표시자 토큰을 포함하는 URL 문자열입니다.
URL 자리 표시자
| 이름 | 형 | 필수 | 노트 |
|---|---|---|---|
{lower_id} |
문자열 | 예 | 패키지 ID(소문자) |
{lower_version} |
문자열 | 예 | 패키지 버전( 소문자) |
lower_id 및 lower_version 모두 에 의해 구현된 규칙을 사용하여 소문자를 지정합니다. NET's
System.String.ToLowerInvariant() 메서드입니다.
lower_version NuGet의 버전 정규화 규칙사용하여 정규화된 원하는 패키지 버전입니다. 즉, 이 경우 SemVer 2.0.0 사양에서 허용하는 빌드 메타데이터를 제외해야 합니다.
응답 본문
패키지에 추가 작업이 있는 경우 200 상태 코드가 반환됩니다. 응답 본문은 추가 정보 콘텐츠 자체가 됩니다.
패키지에 추가 작업이 없으면 404 상태 코드가 반환됩니다.