1.6. 매핑 규칙

매핑 규칙은 API에 대한 요청에 따라 보고할 지표(및 메서드)를 정의합니다.

기본적으로 매우 간단한 매핑 규칙으로 시작합니다.

매핑 규칙

이 규칙은 / 로 시작하는 모든 GET 요청이 지표 적중 을 1씩 증가시킵니다. 이 매핑 규칙은 API에 대한 모든 요청과 일치합니다. 이 규칙은 너무 일반적이므로 대부분 변경할 가능성이 높습니다.

APIcast는 다음과 같은 방법으로 매개변수를 가져옵니다.

  • GET 메서드: APIcast는 쿼리 문자열에서 매개 변수를 가져옵니다.
  • 이러한 모든 방법(databind, DELETE, PUT): APIcast는 본문에서 매개 변수를 가져옵니다.

매개 변수의 이름은 와일드카드로 지정될 수도 있습니다. 슬래시 또는 슬래시와 점 사이에 와일드카드가 표시될 수 있습니다.

예를 들어 아래에서 Echo API에 대한 규칙을 확인할 수 있습니다.

hello World 매핑 규칙

매핑 규칙은 쿼리 문자열 또는 본문에 대한 매개 변수를 포함할 수도 있습니다. /{word}?value={value}.

규칙 일치는 접두사로 수행되며 임의로 복잡할 수 있습니다. 표기법은 Swagger 및 ActiveDocs 사양을 따릅니다.

  • 리터럴 문자열 /hello를 통해 경로에서 일치를 수행할 수 있습니다.
  • 매핑 규칙은 이름이 지정된 와일드카드를 포함할 수 있습니다. /{word}

이 규칙은 자리 표시자 {word} 의 모든 항목과 일치하므로 /morning 과 같은 요청이 규칙과 일치합니다.

슬래시 또는 슬래시와 점 사이에 와일드카드가 표시될 수 있습니다.

  • 매핑 규칙은 쿼리 문자열 또는 본문에 대한 매개 변수를 포함할 수도 있습니다. /{word}?value={value}

APIcast는 GET인 경우 쿼리 문자열에서 매개 변수를 가져오고 POST, DELETE, PUT일 때 본문에서 매개 변수를 가져옵니다.

매개 변수의 이름은 와일드카드로 지정될 수도 있습니다.

기본적으로 지정한 정렬에 따라 모든 매핑 규칙이 처음부터 마지막까지 평가됩니다. 위의 숫자에 규칙 /v1 을 추가하는 경우 /v1로 시작하는 경로가 /v1로 시작하는 요청과 일치합니다. /v1/word 또는 /v1/sentence.