1.2.2. 매핑 규칙 일치

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

  • 매핑 규칙은 슬래시(/)로 시작해야 합니다.
  • 리터럴 문자열(예: /hello)을 통해 경로에서 일치를 수행할 수 있습니다.

  • 매핑 규칙은 쿼리 문자열 또는 본문에 매개 변수를 포함할 수 있습니다(예: /{word}?value={value}). APIcast는 다음과 같은 방식으로 매개변수를 가져옵니다.

    • GET 메서드: 쿼리 문자열에서 다음을 수행합니다.
    • POST,DELETE 또는 PUT 메서드: 본문에서.
  • 매핑 규칙은 이름이 지정된 와일드카드(예: /{word})를 포함할 수 있습니다. 이 규칙은 자리 표시자 {word} 의 모든 내용과 일치하므로 /morning과 같은 요청이 규칙과 일치합니다. 와일드카드는 슬래시 간에 또는 슬래시와 점 사이에 나타날 수 있습니다. 매개 변수에는 와일드카드가 포함될 수도 있습니다.
  • 기본적으로 모든 매핑 규칙은 지정한 정렬에 따라 처음부터 마지막까지 평가됩니다. 규칙 /v1 을 추가하면 경로가 /v 1로 시작하는 요청(예: /v 1/word 또는 /v1/sentence )과 일치합니다.
  • 패턴 끝에 달러 기호($)를 추가하여 정확한 일치를 지정할 수 있습니다. 예를 들어 /v1/word$ 는 /v1/word 요청만 일치하며 /v1/word/hello 요청과 일치하지 않습니다. 정확한 일치를 위해 모든(/)와 일치하는 기본 매핑 규칙이 비활성화되었는지 확인해야 합니다.
  • 둘 이상의 매핑 규칙이 요청 경로와 일치할 수 있지만 일치하지 않으면 요청이 HTTP 404 상태 코드로 삭제됩니다.