다음을 통해 공유

수동으로 API 추가

적용 대상: 모든 API Management 계층

이 문서에서는 Azure API Management에 API를 수동으로 추가하는 방법을 보여줍니다. API에서 모의 응답을 만들려는 경우 빈 API를 만들 수 있습니다. 모의 API 응답을 만드는 방법에 대한 자세한 내용은 Mock API 응답을 참조하세요.

기존 API를 가져오려면 이 문서의 관련 콘텐츠 섹션을 참조하세요.

이 문서에서는 빈 API를 만드는 방법을 알아봅니다. httpbin.org(공개 테스트 서비스)를 백 엔드 API로 지정합니다.

필수 조건

API Management 인스턴스로 이동

  1. Azure Portal에서 API Management 서비스를 검색하고 선택합니다.

    검색 결과에서 API Management 서비스를 보여 주는 스크린샷

  2. API Management 서비스 페이지에서 API Management 인스턴스를 선택합니다.

    API Management 서비스 페이지의 API Management 인스턴스를 보여 주는 스크린샷

API 만들기

  1. 왼쪽 메뉴의 API 에서 API를 선택합니다.

  2. +API 추가를 선택합니다.

  3. HTTP 타일을 선택합니다.

    Azure Portal의 HTTP 타일을 보여 주는 스크린샷.

  4. 백 엔드 웹 서비스 URL(예 https://httpbin.org:)과 API에 대한 기타 설정을 입력합니다. 설정은 첫 번째 API 가져오기 및 게시 자습서에 설명되어 있습니다.

  5. 만들기를 실행합니다.

이때 백 엔드 API의 작업에 매핑되는 API Management의 작업은 없습니다. 백 엔드를 통해 노출되지만 API Management를 통해 노출되지 않는 작업을 호출하면 404 오류가 발생합니다.

참고 항목

기본적으로 API를 추가할 때 백 엔드 서비스에 연결된 경우에도 API Management는 사용자가 허용할 때까지 작업을 노출하지 않습니다. 백 엔드 서비스의 작업을 허용하려면 백 엔드 작업에 매핑되는 API Management 작업을 만듭니다.

작업 추가 및 테스트

이 섹션에서는 /get 작업을 추가하여 백엔드 http://httpbin.org/get 작업에 매핑하는 방법을 보여 줍니다.

작업 추가

  1. 이전 단계에서 만든 API를 선택합니다.
  2. "+작업 추가를 선택합니다.
  3. URL에서 GET을 선택하고 텍스트 상자에 /get을 입력합니다.
  4. 표시 이름에 FetchData를 입력합니다.
  5. 저장을 선택합니다.

작업 테스트

Azure Portal에서 작업을 테스트합니다. (개발자 포털에서 테스트할 수도 있습니다.)

  1. 테스트 탭을 선택합니다.
  2. FetchData를 선택합니다.
  3. 보내기를 선택합니다.

작업이 생성하는 응답 http://httpbin.org/get 은 HTTP 응답 섹션에 나타납니다. 작업을 변환하려면 API 변환 및 보호를 참조하세요.

매개 변수가 있는 작업 추가 및 테스트

이 섹션에서는 매개 변수를 사용하는 작업을 추가하는 방법을 보여 줍니다. 예제에서는 작업을 http://httpbin.org/status/200에 매핑합니다.

작업 추가

  1. 이전에 만든 API를 선택합니다.
  2. 디자인 탭에서 + 작업 추가를 선택합니다.
  3. URL에서 GET을 선택하고 텍스트 상자에 /status/{code}를 입력합니다.
  4. 표시 이름에 GetStatus를 입력합니다.
  5. 저장을 선택합니다.

작업 테스트

Azure Portal에서 작업을 테스트합니다. (개발자 포털에서 테스트할 수도 있습니다.)

  1. 테스트 탭을 선택합니다.

  2. GetStatus를 선택합니다. 코드에서 200을 입력합니다.

  3. 보내기를 선택합니다.

    작업이 생성하는 응답 http://httpbin.org/status/200 은 HTTP 응답 섹션에 나타납니다. 작업을 변환하려면 API 변환 및 보호를 참조하세요.

와일드카드 작업 추가 및 테스트

이 섹션에서는 와일드카드 작업을 추가하는 방법을 보여줍니다. 와일드카드 작업을 사용하면 API 요청을 사용하여 임의의 값을 전달할 수 있습니다. 이전 섹션에 표시된 대로 별도의 GET 작업을 만드는 대신 와일드카드 GET 작업을 만들 수 있습니다.

주의

와일드카드 작업을 구성할 때는 주의해야 합니다. 이 구성은 특정 API 보안 위협에 API를 더 취약하게 만들 수 있습니다.

작업 추가

  1. 이전에 만든 API를 선택합니다.
  2. 디자인 탭에서 + 작업 추가를 선택합니다.
  3. URL에서 GET을 선택하고 텍스트 상자에 *를 입력/합니다.
  4. 표시 이름에 와일드카드Get을 입력합니다.
  5. 저장을 선택합니다.

작업 테스트

Azure Portal에서 작업을 테스트합니다. (개발자 포털에서 테스트할 수도 있습니다.)

  1. 테스트 탭을 선택합니다.

  2. WildcardGet을 선택합니다. 이전 섹션에서 테스트한 GET 작업을 시도하거나 지원되는 다른 GET 작업을 시도합니다.

    예를 들어 템플릿 매개 변수에서 와일드카드(*) 이름 옆에 있는 값을 헤더로 변경 합니다. 이 작업은 들어오는 요청의 HTTP 헤더를 반환합니다.

  3. 보내기를 선택합니다.

    작업이 생성하는 응답 http://httpbin.org/headers 은 HTTP 응답 섹션에 나타납니다. 작업을 변환하려면 API 변환 및 보호를 참조하세요.

참고 항목

통합하려는 백 엔드 API의 호스트가 작업 URL에서 후행 슬래시를 처리하는 방법을 이해하는 것이 중요할 수 있습니다. 자세한 내용은 이 API Management FAQ를 참조하세요.

다른 API 추가

다음을 포함하여 다양한 서비스에서 노출되는 API에서 API를 작성할 수 있습니다.

  • OpenAPI 사양
  • SOAP API
  • GraphQL API
  • Azure App Service에서 호스트되는 웹앱
  • Azure Functions (애저 펑션)
  • Azure 논리 앱
  • Azure 서비스 패브릭

참고 항목

API를 가져올 때 작업은 현재 API에 추가됩니다.

기존 API에 API를 추가하려면 다음을 수행합니다.

  1. Azure Portal에서 Azure API Management 인스턴스로 이동합니다.

    API Management 서비스 페이지를 보여 주는 스크린샷

  2. 개요 페이지에서 API를 선택하거나 왼쪽 메뉴에서 API API>를 선택합니다.

    개요 페이지의 API 선택을 보여 주는 스크린샷.

  3. 다른 API를 추가할 API 옆에 있는 줄임표(...)를 선택합니다.

  4. 드롭다운 메뉴에서 가져오기 를 선택합니다.

    가져오기 명령을 보여 주는 스크린샷.

  5. API를 가져올 서비스를 선택합니다.

관련 콘텐츠