1.6. 매핑 규칙
매핑 규칙은 API에 대한 요청에 따라 보고할 지표(및 메서드)를 정의합니다.
기본적으로 매우 간단한 매핑 규칙으로 시작합니다.
이 규칙은 /
로 시작하는 모든 GET
요청이 지표 적중
을 1씩 증가시킵니다. 이 매핑 규칙은 API에 대한 모든 요청과 일치합니다. 이 규칙은 너무 일반적이므로 대부분 변경할 가능성이 높습니다.
APIcast는 다음과 같은 방법으로 매개변수를 가져옵니다.
- GET 메서드: APIcast는 쿼리 문자열에서 매개 변수를 가져옵니다.
- 이러한 모든 방법(databind, DELETE, PUT): APIcast는 본문에서 매개 변수를 가져옵니다.
매개 변수의 이름은 와일드카드로 지정될 수도 있습니다. 슬래시 또는 슬래시와 점 사이에 와일드카드가 표시될 수 있습니다.
예를 들어 아래에서 Echo API에 대한 규칙을 확인할 수 있습니다.
매핑 규칙은 쿼리 문자열 또는 본문에 대한 매개 변수를 포함할 수도 있습니다. /{word}?value={value}
.
규칙 일치는 접두사로 수행되며 임의로 복잡할 수 있습니다. 표기법은 Swagger 및 ActiveDocs 사양을 따릅니다.
-
리터럴 문자열
/hello
를 통해 경로에서 일치를 수행할 수 있습니다. -
매핑 규칙은 이름이 지정된 와일드카드를 포함할 수 있습니다.
/{word}
이 규칙은 자리 표시자 {word}
의 모든 항목과 일치하므로 /morning
과 같은 요청이 규칙과 일치합니다.
슬래시 또는 슬래시와 점 사이에 와일드카드가 표시될 수 있습니다.
-
매핑 규칙은 쿼리 문자열 또는 본문에 대한 매개 변수를 포함할 수도 있습니다.
/{word}?value={value}
APIcast는 GET인 경우 쿼리 문자열에서 매개 변수를 가져오고 POST, DELETE, PUT일 때 본문에서 매개 변수를 가져옵니다.
매개 변수의 이름은 와일드카드로 지정될 수도 있습니다.
기본적으로 지정한 정렬에 따라 모든 매핑 규칙이 처음부터 마지막까지 평가됩니다. 위의 숫자에 규칙 /v1
을 추가하는 경우 /v1로 시작하는 경로가 /v1로 시작하는 요청과 일치합니다. /v1/word
또는 /v1/sentence
.