다음을 통해 공유

자습서: 첫 번째 API 가져오기 및 게시

  • 아티클

적용 대상: 모든 API Management 계층

이 자습서에서는 JSON 형식의 OpenAPI 사양 백 엔드 API를 Azure API Management로 가져오는 방법을 보여 줍니다. 이 예제에서는 오픈 소스 Petstore API를 가져옵니다.

백엔드 API를 API Management로 가져오면 API Management API가 백엔드 API의 외관이 됩니다. 백엔드 API에 연결하지 않고도 API Management에서 요구 사항에 맞게 외관을 사용자 지정할 수 있습니다. 자세한 내용은 API 변환 및 보호를 참조하세요.

이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.

  • API Management로 API 가져오기
  • Azure Portal에서 API 테스트

가져온 후에는 Azure Portal에서 API를 관리할 수 있습니다.

포털의 API Management에 있는 새 API의 스크린샷.

필수 조건

API Management 인스턴스로 이동

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

    API Management Services 선택

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

    API Management 인스턴스 선택

백 엔드 API 가져오기 및 게시

이 섹션에서는 OpenAPI 사양 백 엔드 API를 가져오고 게시하는 방법을 보여 줍니다.

  1. API Management 인스턴스의 왼쪽 탐색 영역에서 API를 선택합니다.

  2. OpenAPI 타일을 선택합니다.

  3. OpenAPI 사양에서 만들기 창에서 전체를 선택합니다.

  4. 다음 표의 값을 나열합니다.

    만들기 중에 또는 나중에 설정 탭으로 이동하여 API 값을 설정할 수 있습니다.

    포털에서 API를 만드는 스크린샷.

    설정 값 설명
    OpenAPI 사양 https://petstore3.swagger.io/api/v3/openapi.json API를 구현하는 백 엔드 서비스 및 API에서 지원하는 작업을 지정합니다.

    백 엔드 서비스 URL은 나중에 API의 설정 페이지에서 웹 서비스 URL로 표시됩니다.

    가져온 후에는 사양에서 작업을 추가, 편집, 이름 바꾸기 또는 삭제할 수 있습니다.
    작업 템플릿에 쿼리 매개 변수 포함 선택됨(기본값) 사양에서 필요한 쿼리 매개 변수를 API Management의 템플릿 매개 변수로 가져올지 여부를 지정합니다.
    표시 이름 OpenAPI 사양 URL이 입력되면 API Management에서 JSON을 기반으로 하여 이 필드를 채웁니다. 개발자 포털에 표시되는 이름입니다.
    이름 OpenAPI 사양 URL이 입력되면 API Management에서 JSON을 기반으로 하여 이 필드를 채웁니다. API에 대한 고유 이름입니다.
    설명 OpenAPI 사양 URL이 입력되면 API Management에서 JSON을 기반으로 하여 이 필드를 채웁니다. API에 대한 선택적 설명입니다.
    URL 구성표 HTTPS API에 액세스하는 데 사용할 수 있는 프로토콜입니다.
    API URL 접미사 펫스토어 API Management 서비스의 기준 URL에 추가된 접미사입니다. API Management는 해당 접미사로 API를 구분하므로 접미사는 지정된 게시자의 모든 API에 대해 고유해야 합니다.
    태그 검색, 그룹화 또는 필터링을 위해 API를 구성하는 태그입니다.
    제품 무제한 하나 이상의 API에 대한 연결입니다. 특정 계층에서 API Management 인스턴스에는 스타터 및 무제한이라는 두 가지 샘플 제품이 함께 제공됩니다. API를 제품과 연결하여 개발자 포털에 API를 게시합니다.

    여러 API를 제품에 포함시키고 개발자 포털을 통해 개발자에게 제품 구독을 제공할 수 있습니다. 이 API를 다른 제품에 추가하려면 제품 이름을 입력하거나 선택합니다. API를 여러 제품에 추가하려면 이 단계를 반복합니다. 나중에 설정 페이지에서 API를 제품에 추가할 수도 있습니다.

    제품에 대한 자세한 내용은 제품 만들기 및 게시를 참조하세요.
    게이트웨이 관리 API를 노출하는 API 게이트웨이입니다. 이 필드는 Developer 및 Premium 계층 서비스에서만 사용할 수 있습니다.

    관리는 API Management 서비스에 기본 제공되고 Azure에서 Microsoft가 호스트하는 게이트웨이를 나타냅니다. 자체 호스트 게이트웨이는 Premium 및 Developer 서비스 계층에서만 사용할 수 있습니다. 온-프레미스 또는 다른 클라우드에 배포할 수 있습니다.

    게이트웨이를 선택하지 않으면 API를 사용할 수 없으며 API 요청이 실패합니다.
    API 버전 관리 선택 또는 선택 취소 자세한 내용은 여러 버전의 API 게시를 참조하세요.

  5. 만들기를 선택하여 API를 만듭니다.

API 정의를 가져오는 데 문제가 있는 경우 알려진 문제 및 제한 사항 목록을 참조하세요.

Azure Portal에서 새 API 테스트

Azure Portal에서 직접 API 작업을 호출합니다. 그러면 작업을 보고 테스트할 수 있는 편리한 방법이 제공됩니다. 기본적으로 포털의 테스트 콘솔에서 API는 기본 제공 모든 액세스 구독의 키를 사용하여 호출됩니다. 제품 범위가 지정된 구독 키를 사용하여 API 호출을 테스트할 수도 있습니다.

  1. API Management 인스턴스의 왼쪽 탐색 영역에서 API>Swagger Petstore를 선택합니다.

  2. 테스트 탭을 선택한 다음 상태별 애완 동물 찾기를 선택합니다. 페이지에는 상태 쿼리 매개 변수가 표시됩니다. 보류 중과 같은 사용 가능한 값 중 하나를 선택합니다. 여기에서 쿼리 매개 변수 및 헤더를 추가할 수도 있습니다.

    HTTP 요청 섹션에서 Ocp-Apim-Subscription-Key 헤더가 자동으로 채워집니다. 그러면 "눈" 아이콘을 선택하는지 확인할 수 있습니다.

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

    Azure Portal에서 API 테스트 스크린샷.

    백 엔드는 200 정상 및 일부 데이터로 응답합니다.

다음 단계

이 자습서에서는 다음 작업 방법을 알아보았습니다.

  • 첫 번째 API 가져오기
  • Azure Portal에서 API 테스트

제품을 만들고 게시하는 방법을 알아보려면 다음 자습서로 진행하세요.

제품 생성 및 게시