API 게시

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

<ph type="x-smartling-placeholder">

다음 섹션에 설명된 대로 앱 개발자가 사용할 수 있도록 API를 포털에 게시합니다.

API 게시 개요

포털에 API를 게시하는 과정은 두 단계로 이루어집니다.

  1. 포털에 게시할 API 제품을 선택합니다.
  2. 앱 개발자가 API에 대해 알아볼 수 있도록 OpenAPI 문서 또는 GraphQL 스키마의 스냅샷에서 API 참조 문서를 렌더링합니다. 스냅샷에 대한 자세한 내용은 스냅샷이란 무엇인가요?를 참조하세요.

포털에 무엇이 게시되나요?

API를 게시하면 포털에 다음 업데이트가 자동으로 적용됩니다.
  • API 참조 문서. 제공되는 인터페이스는 OpenAPI 문서 또는 GraphQL 스키마를 사용하여 API를 게시하는지 여부에 따라 다릅니다. 다음을 참조하세요.
  • API 참조 페이지에 대한 링크가 API 페이지에 추가됩니다.

    API 페이지(샘플 포털에 포함됨)에서는 자세한 정보를 볼 수 있는 해당 API 참조 문서에 대한 링크와 함께 포털에 게시된 모든 API 목록을 알파벳 순서로 보여줍니다. 선택적으로 다음을 맞춤설정할 수 있습니다.

    • 각 API 카드에 표시되는 이미지
    • 개발자가 API 페이지의 관련 API를 검색하도록 API 태그를 지정하는데 사용되는 카테고리

    두 가지 카테고리와 이미지 사용을 보여주는 실시간 포털의 API 페이지

    • SmartDocs(OpenAPI)

    OpenAPI 문서를 사용하여 API를 게시하면 SmartDocs API 참조 문서가 포털에 추가됩니다.

    개발자는 SmartDocs API 참조 문서를 검토하고 API 사용해 보기 패널을 사용하여 API를 요청하고 출력을 볼 수 있습니다. OpenAPI 문서에 정의된 보안 방법을 기반으로 기본, API 키 또는 OAuth 인증을 사용하는 비보안 엔드포인트 또는 보안 엔드포인트에서 이 API를 사용해 보세요. OAuth의 경우 승인 코드, 비밀번호, 클라이언트 사용자 인증 정보 흐름이 지원됩니다.

    API 참조 문서 페이지는 API 호출 승인, API 사용해 보기 패널 고정 해제, 관련 사양 다운로드, API 실행 방법을 보여주는 콜아웃을 포함합니다.

    를 클릭하여 이 API 사용해 보기 패널을 펼치세요. 펼친 패널을 사용하면 아래와 같이 HTTP, Python, Node.js 등의 다양한 형식의 curl 호출 및 코드 샘플을 볼 수 있습니다.

    확장된 API 사용해 보기 패널

    GraphQL 탐색기

    GraphQL 스키마를 사용하여 API를 게시하면 GraphQL 탐색기가 포털에 추가됩니다. GraphQL 탐색기는 API에 대한 쿼리를 실행하기 위한 대화형 플레이그라운드입니다. 이 탐색기는 GraphQL Foundation에서 개발한 GraphQL IDE의 참조 구현인 GraphiQL을 기반으로 합니다.

    개발자는 GraphQL 탐색기를 사용하여 스키마 기반 대화형 문서를 탐색하고, 쿼리를 빌드하고 실행하고, 쿼리 결과를 보고, 스키마를 다운로드할 수 있습니다. API에 대한 액세스를 보호하기 위해 개발자는 요청 헤더 창에 승인 헤더를 전달할 수 있습니다.

    GraphQL에 대한 자세한 내용은 graphql.org를 참조하세요.

    포털의 GraphQL 탐색기

    스냅샷이란?

    각 OpenAPI 또는 GraphQL 문서는 API의 수명 주기 전반에 걸쳐 소스 역할을 합니다. 개발부터 게시, 모니터링에 이르기까지 API 수명 주기의 각 단계에서 동일한 문서가 사용됩니다. 문서를 변경할 때는 문서를 변경하면 어떻게 되나요?에 설명된 대로 다른 수명 주기 단계를 통해 변경사항이 API에 미치는 영향의 영향을 알고 있아야 합니다.

    API를 게시하면 OpenAPI 또는 GraphQL 문서의 스냅샷을 가져와 API 참조 문서를 렌더링합니다. 해당 스냅샷은 문서의 특정 버전을 나타냅니다. 문서를 수정할 경우 API 참조 문서의 최신 변경사항을 반영하기 위해 문서의 다른 스냅샷을 생성할 지 결정할 수 있습니다.

    콜백 URL 정보

    앱에 OAuth 2.0 승인 코드 부여 유형(종종 '3-legged OAuth'로 지칭)을 사용할 때와 같이 콜백 URL이 필요한 경우 개발자가 앱을 등록할 때 콜백 URL을 지정하도록 요구할 수 있습니다. 콜백 URL은 보통 클라이언트 앱을 대신하여 승인 코드를 수신하도록 지정된 앱의 URL을 지정합니다. 자세한 내용은 승인 코드 부여 유형 구현을 참조하세요.

    포털에 API를 추가할 때 앱 등록 중에 콜백 URL을 요구할지 여부를 구성할 수 있습니다. 이 설정은 API의 콜백 URL 관리에 설명된 대로 언제든지 수정할 수 있습니다.

    앱을 등록할 때 개발자는 앱 등록에 설명된 대로 콜백 URL이 필요한 모든 API를 위한 콜백 URL을 입력해야 합니다.

    'API 사용해 보기'를 지원하도록 API 프록시 구성

    OpenAPI 문서를 사용하여 API를 게시하기 전에 다음과 같이 SmartDocs API 참조 문서의 API 사용해 보기 패널에서 요청하는 것을 지원하도록 API 프록시를 구성해야 합니다.

    • API 프록시에 CORS 지원을 추가하여 클라이언트 측 교차 출처 요청 적용

      CORS는 웹페이지에서 실행되는 JavaScript XMLHttpRequest(XHR) 호출이 출처가 아닌 도메인의 리소스와 상호작용할 수 있도록 허용하는 표준 메커니즘입니다. CORS는 모든 브라우저에서 적용되는 '동일 출처 정책'에 일반적으로 구현되는 솔루션입니다.

    • 기본 인증 또는 OAuth2를 사용하는 경우 API 프록시 구성 업데이트

    다음 표에는 인증 액세스에 기반한 SmartDocs API 참조 문서에서 이 API 패널 사용해 보기를 지원하기 위한 API 프록시 구성 요구사항이 요약되어 있습니다.

    인증 액세스 정책 구성 요구사항
    없음 또는 API 키 API 프록시에 CORS 지원을 추가합니다. 편의를 위해 GitHub에 제공된 샘플 CORS 솔루션을 사용하거나 API 프록시에 CORS 지원 추가에 설명된 단계를 따르세요.
    기본 인증 다음 단계를 수행합니다.
    1. API 프록시에 CORS 지원을 추가합니다. 편의를 위해 GitHub에 제공된 샘플 CORS 솔루션을 사용하거나 API 프록시에 CORS 지원 추가에 설명된 단계를 따르세요.
    2. CORS AssignMessage 정책에서 Access-Control-Allow-Headers 헤더에 authorization 속성이 포함되는지 확인합니다. 예를 들면 다음과 같습니다. 
      <Header name="Access-Control-Allow-Headers">
  origin, x-requested-with, accept, content-type, authorization
</Header>
    OAuth2
    1. API 프록시에 CORS 지원을 추가합니다. 편의를 위해 GitHub에 제공된 샘플 CORS 솔루션을 사용하거나 API 프록시에 CORS 지원 추가에 설명된 단계를 따르세요.
    2. CORS AssignMessage 정책에서 Access-Control-Allow-Headers 헤더에 authorization 속성이 포함되는지 확인합니다. 예를 들면 다음과 같습니다. 
      <Header name="Access-Control-Allow-Headers">
  origin, x-requested-with, accept, content-type, authorization
</Header>
    3. OAuth2 정책에서 RFC를 준수하지 않는 동작을 수정합니다. 편의를 위해 GitHub에 제공된 샘플 OAuth2 솔루션을 사용하거나 다음 단계를 수행하세요.
      • OAuth2 정책의 <GrantType> 요소가 request.formparam.grant_type(양식 매개변수)으로 설정되어 있는지 확인합니다. 자세한 내용은 <GrantType>을 참조하세요.
      • OAuth2 정책의 token_type이 기본 BearerToken이 아닌 Bearer으로 설정되어 있는지 확인합니다.

    API 카탈로그 살펴보기

    API 카탈로그를 보려면 다음 안내를 따르세요. 1. 게시 > 포털을 선택하고 포털을 선택합니다. 2. 포털 홈페이지에서 API 카탈로그를 클릭합니다. 또는 상단 탐색 메뉴의 포털 드롭다운 메뉴에서 API 카탈로그를 선택할 수 있습니다.

    API 카탈로그의 API 탭에는 포털에 추가된 API 목록이 표시됩니다.

    이름, 설명, 공개 상태, 카테고리, 관련 사양, 수정 시간을 포함하여 API에 대한 정보를 표시하는 API 탭

    이전 그림에 강조표시된 대로 API 탭에서는 다음 작업을 수행할 수 있습니다.

    포털에 API 추가

    포털에 API를 추가하려면 다음 안내를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.

    3. +를 클릭합니다.

      카탈로그에 제품 추가 API 대화상자가 표시됩니다.

    4. 포털에 추가할 API 제품을 선택하세요.

    5. 다음을 클릭합니다. API 세부정보 페이지가 표시됩니다.

    6. 다음과 같이 포털에서 API 참조 문서 콘텐츠 및 공개 상태를 구성합니다.

      필드 설명
      게시됨게시됨을 선택하여 포털에 API를 게시합니다. API를 게시할 준비가 되지 않은 경우 체크박스를 선택 해제합니다. 나중에 포털에서 API 게시 또는 게시 취소에 설명된 대로 설정을 변경할 수 있습니다.
      표시 제목 카탈로그에 표시되는 API 제목을 업데이트합니다. 기본적으로 API 제품 이름이 사용됩니다. 나중에 표시 제목 및 설명 수정에 설명된 대로 표시 제목을 변경할 수 있습니다.
      표시 설명 카탈로그에 표시되는 API 설명을 업데이트합니다. 기본적으로 API 제품 설명이 사용됩니다. 나중에 표시 제목 및 설명 수정에 설명된 대로 표시 설명을 변경할 수 있습니다.
      개발자가 콜백 URL을 지정하도록 요구앱 개발자가 콜백 URL을 지정하도록 하려면 사용 설정합니다. 나중에 API의 콜백 URL 관리에 설명된 대로 콜백 URL을 추가하거나 업데이트할 수 있습니다.
      API 참고 리소스 OpenAPI 문서를 사용하려면:
      1. OpenAPI 문서를 선택합니다.
      2. 문서 선택을 클릭합니다.
      3. 다음 단계 중 하나를 수행합니다.
        • My Specs(내 사양) 탭을 클릭하고 사양 저장소에서 사양을 선택합니다.
        • 파일 업로드 탭을 클릭하고 파일을 업로드합니다.
        • URL에서 가져오기 탭을 클릭하고 URL에서 사양을 가져옵니다.
      4. 선택을 클릭합니다.

      GraphQL 스키마를 사용하려면:

      1. GraphQL 스키마를 선택합니다.
      2. 문서 선택을 클릭합니다.
      3. GraphQL 스키마로 이동하여 선택합니다.
      4. 선택을 클릭합니다.

      또는 문서의 스냅샷 관리에 설명된 대로 문서 없음을 선택하고 API를 추가한 후에 문서를 추가할 수 있습니다.

      API 공개 상태

      잠재고객 관리 기능의 베타 출시 버전에 등록하지 않은 경우 다음 옵션 중 하나를 선택합니다.

      • 모든 사용자가 API를 볼 수 있도록 익명의 사용자
      • 등록된 사용자만 API를 볼 수 있도록 등록된 사용자

      잠재고객 관리 기능의 베타 출시 버전에 등록한 경우 다음 옵션 중 하나를 선택합니다.

      • 모든 사용자가 API를 볼 수 있도록 공개(모든 사용자에게 표시)
      • 등록된 사용자만 API를 볼 수 있도록 인증된 사용자
      • API를 볼 수 있는 특정 잠재고객을 선택할 수 있도록 선택한 잠재고객

      포털의 API 공개 상태 관리에 설명된 대로 나중에 잠재고객 공개 상태를 관리할 수 있습니다.

      디스플레이 이미지 API 페이지의 API 카드에 이미지를 표시하려면 이미지 선택을 클릭합니다. 이미지 선택 대화상자에서 기존 이미지를 선택하거나, 새 이미지를 업로드하거나, 외부 이미지의 URL을 제공하고, 선택을 클릭합니다. API 썸네일 미리보기를 표시하고 선택을 클릭합니다. 나중에 API 카드의 이미지 관리에 설명된 대로 이미지를 추가할 수 있습니다. 외부 URL로 이미지를 지정하면 이미지가 애셋에 업로드되지 않습니다. 또한 통합 포털의 이미지 로드는 사용 가능 여부에 따라 달라지며, 이는 콘텐츠 보안 정책에 의해 차단되거나 제한될 수 있습니다.
      카테고리

      앱 개발자가 API 페이지에서 관련 API를 검색할 수 있도록 API에 태그를 지정할 카테고리를 추가합니다. 카테고리를 식별하려면 다음 안내를 따르세요.

      • 드롭다운 목록에서 카테고리를 선택합니다.
      • 이름을 입력하고 Enter 키를 눌러 새 카테고리를 추가합니다. 새 카테고리가 카테고리 페이지에 추가되어 다른 API를 추가하거나 수정할 때 사용할 수 있습니다.

    7. 저장을 클릭합니다.

    문서 스냅샷 관리

    API를 게시한 후에는 언제든지 OpenAPI 또는 GraphQL 문서의 새로운 스냅샷을 만들어 포털에 게시된 API 참조 문서를 업데이트할 수 있습니다.

    문서의 스냅샷을 관리하려면 다음 안내를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.
    3. 수정할 API 행을 클릭합니다.
    4. 스냅샷 상태를 확인합니다. 이전 버전일 경우, 다음과 같은 메시지가 표시됩니다. 오래된 스냅샷을 나타내는 아이콘 및 메시지
    5. 수정 아이콘를 클릭합니다.
    6. 다음 작업 중 하나를 수행합니다.
      • 오래된 OpenAPI 문서의 스냅샷을 새로고침하려면 스냅샷 새로고침을 클릭합니다.
      • API용 문서를 생성하는 데 사용되는 문서를 변경하려면 API 문서에서 문서 선택을 클릭하고 새 문서를 선택합니다.
    7. 저장을 클릭합니다.

    API 참조 문서는 문서에서 렌더링되고 API 참조 페이지에 추가됩니다. 스냅샷 상태가 최신으로 업데이트됩니다.

    스냅샷이 최신 상태임을 나타내는 아이콘과 메시지

    포털에서 API 게시 또는 게시 취소

    포털에 API를 게시하거나 게시 취소하려면 다음 단계를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.
    3. 수정할 API 행을 클릭합니다.
    4. 수정 아이콘를 클릭합니다.
    5. API 세부정보에서 게시(카탈로그 나열)를 선택하거나 선택 해제하여 포털에 API를 게시하거나 게시 취소합니다.
    6. 저장을 클릭합니다.

    포털에서 API 공개 상태 관리

    포털에서 다음 액세스를 허용하여 API 공개 상태를 관리합니다.

    포털에서 API 공개 상태를 관리하려면 다음 단계를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.
    3. 수정할 API 행을 클릭합니다.
    4. 수정 아이콘를 클릭합니다.
    5. API 공개 상태에서 다음 옵션 중 하나를 선택합니다.

    6. 공개 상태 설정을 선택합니다. 잠재고객 기능의 베타 출시 버전에 등록된 경우 다음 옵션 중 하나를 선택합니다.

      • 공개(모든 사용자에게 표시): 모든 사용자가 페이지를 볼 수 있도록 합니다.
      • 등록된 사용자를 선택하여 등록된 사용자만 페이지를 볼 수 있도록 합니다.
      • 선택된 잠재고객: 페이지를 볼 수 있는 특정 잠재고객을 선택합니다. 포털의 잠재고객 관리를 참조하세요.
      그렇지 않으면 다음 옵션 중 하나를 선택합니다.
      • 익명의 사용자를 선택하여 모든 사용자가 페이지를 볼 수 있도록 합니다.
      • 등록된 사용자를 선택하여 등록된 사용자만 페이지를 볼 수 있도록 합니다.

    7. 제출을 클릭합니다.

    API의 콜백 URL 관리

    API의 콜백 URL을 관리하세요. 콜백 URL 정보를 참조하세요.

    API의 콜백 URL을 관리하려면 다음 안내를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.
    3. 수정할 API 행을 클릭합니다.
    4. 수정 아이콘를 클릭합니다.
    5. API 세부정보에서 게시(카탈로그 나열)를 선택하거나 선택 해제하여 포털에 API를 게시하거나 게시 취소합니다.
    6. 저장을 클릭합니다.

    API 카드의 이미지 관리

    현재 이미지를 추가하거나 변경하여 API 페이지에서 API 카드가 표시된 이미지를 관리합니다.

    API 카드의 이미지를 관리하려면 다음 안내를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.
    3. 수정할 API 행을 클릭합니다.
    4. 수정 아이콘를 클릭합니다.

    5. API 세부정보에서 다음을 수행하세요.

      • 이미지 선택을 클릭하여 이미지를 지정하거나 현재 선택된 이미지가 없는 경우 이미지를 업로드합니다.
      • 이미지 변경을 클릭하여 다른 이미지를 지정하거나 업로드합니다.
      • 이미지를 삭제하려면 이미지에서 x를 클릭합니다.

      이미지를 지정할 때는 카탈로그 항목에 사용된 외부 URL 또는 포털에 저장된 이미지 파일의 파일 경로(예: /files/book-tree.jpg)를 지정합니다. 외부 이미지의 URL을 지정하면 이미지가 애셋에 업로드되지 않습니다. 또한 통합 포털에서 이미지를 로드하는 경우 해당 항목의 가용성에 따라 업로드 여부가 달라지며 콘텐츠 보안 정책에 의해 차단되거나 제한될 수 있습니다.

    6. 저장을 클릭합니다.

    카테고리를 사용하여 API에 태그 지정

    다음 방법 중 하나로 카테고리를 사용하여 API에 태그를 지정합니다.

    • 아래 설명된 대로 API를 수정할 때 API가 태그 지정된 카테고리를 관리합니다.
    • 카테고리를 수정할 때 카테고리에 태그가 지정된 API를 관리합니다.

    API를 수정할 때 카테고리에 API를 태그 지정하려면 다음 단계를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.
    3. 수정할 API 행을 클릭합니다.
    4. 수정 아이콘를 클릭합니다.
    5. 카테고리 필드 내부를 클릭하고 다음 단계 중 하나를 수행합니다.
      • 드롭다운 목록에서 카테고리를 선택합니다.
      • 이름을 입력하고 Enter 키를 눌러 새 카테고리를 추가합니다. 새 카테고리가 카테고리 페이지에 추가되어 다른 API를 추가하거나 수정할 때 사용할 수 있습니다.
    6. 더 많은 카테고리에 API 태그를 지정하려면 이 작업을 반복합니다.
    7. 저장을 클릭합니다.

    표시 제목 및 설명 수정

    표시 제목과 설명을 수정하려면 다음 단계를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API 탭을 클릭합니다.
    3. 수정할 API 행을 클릭합니다.
    4. 수정 아이콘를 클릭합니다.
    5. 필요에 따라 제목 표시 및 설명 표시 필드를 수정합니다.
    6. 저장을 클릭합니다.

    포털에서 API 삭제

    포털에서 API를 삭제하려면 다음 안내를 따르세요.

    1. API 카탈로그에 액세스합니다.
    2. 아직 선택하지 않았으면 API를 선택합니다.
    3. 목록에서 API 위로 커서를 이동하면 작업 메뉴가 표시됩니다.
    4. 수정 아이콘 아이콘을 클릭합니다.

    관련 API 검색에 사용되는 카테고리 관리

    카테고리를 사용한 API 태그 지정을 사용하여 앱 개발자가 라이브 포털의 API 페이지에서 관련 API를 검색할 수 있습니다. 다음 섹션에 설명된 대로 카테고리를 추가하고 관리합니다.

    카테고리 페이지 탐색

    카테고리 페이지를 열람하려면 다음 안내를 따르세요.

    1. 게시 > 포털을 선택하고 포털을 선택합니다.
    2. 포털 홈페이지에서 API 카탈로그를 클릭합니다.

      또는 상단 탐색 메뉴의 포털 드롭다운 메뉴에서 API 카탈로그를 선택할 수 있습니다.

    3. 카테고리 탭을 클릭합니다.

    API 카탈로그의 카테고리 탭에는 포털에 정의된 카테고리 목록이 표시됩니다.

    카테고리 탭에는 카테고리 이름과 할당된 API의 총 수가 표시됩니다.

    이전 그림에 강조 표시된 것처럼 API 페이지를 사용하면 다음 작업을 수행할 수 있습니다.

    카테고리 추가

    다음 방법 중 하나를 사용하여 카테고리를 추가합니다.

    • 포털에 API를 추가할 때 카테고리의 이름을 입력합니다.
    • 아래에 설명된 대로 직접 카테고리를 추가합니다.

    새 카테고리가 카테고리 페이지에 추가되어 다른 API를 추가하거나 수정할 때 사용할 수 있습니다.

    카테고리를 직접 추가하려면 다음 안내를 따르세요.

    1. 카테고리 페이지에 액세스합니다.
    2. +를 클릭합니다.
    3. 새 카테고리의 이름을 입력합니다.
    4. 원할 경우 카테고리에 태그 지정할 API를 하나 이상 선택합니다.
    5. 만들기를 클릭합니다.

    카테고리 수정

    카테고리를 수정하려면 다음 안내를 따르세요.

    1. 카테고리 페이지에 액세스합니다.
    2. 를 클릭합니다.
    3. 카테고리의 이름을 수정합니다.
    4. API 태그를 추가하거나 삭제합니다.
    5. 저장을 클릭합니다.

    카테고리 삭제

    카테고리를 삭제하면 카테고리에 지정된 모든 API 태그도 삭제됩니다.

    카테고리를 삭제하려면 다음 안내를 따르세요.

    1. 카테고리 페이지에 액세스합니다.
    2. 수정하려는 카테고리 위에 커서를 이동하여 작업 메뉴를 표시합니다.
    3. 아이콘을 클릭합니다.
    4. 카테고리의 이름을 수정합니다.
    5. API 추가 또는 삭제
    6. 저장을 클릭합니다.

    게시된 API 문제 해결

    다음 섹션에서는 게시된 API로 특정 오류를 해결하는 데 도움이 되는 정보를 제공합니다.

    오류: 이 API 사용해 보기를 사용할 때 반환되는 오류를 가져오지 못했습니다.

    이 API 사용해 보기를 사용할 때 TypeError: Failed to fetch 오류가 반환되면 다음과 같은 가능한 원인과 해결 방법을 참고하세요.

    • 혼합 콘텐츠 오류의 경우 알려진 Swagger UI 문제로 인해 오류가 발생할 수 있습니다. 가능한 해결 방법 중 하나는 OpenAPI 문서의 schemes 정의에서 HTTP 앞에 HTTPS를 지정하는 것입니다. 예를 들면 다음과 같습니다.

      schemes:
   - https
   - http

    • 교차 출처 리소스 공유(CORS) 제한 오류의 경우 API 프록시에 대해 CORS가 지원되는지 확인하세요. CORS는 클라이언트 측 교차 출처 요청을 사용 설정하는 표준 메커니즘입니다. API 사용해 보기 기능을 지원하도록 API 프록시 구성을 참고하세요.

    오류: 'Access-Control-Allow-Origin' 헤더에는 '*', *' 값이 여러 개 포함되어 있지만 하나만 허용됩니다.

    이 API 사용해 보기를 사용할 때 Access-Control-Allow-Origin 헤더가 이미 존재하는 경우 다음과 같은 오류 메시지가 표시될 수 있습니다.

    The 'Access-Control-Allow-Origin' header contains multiple values '*, *', but only one is allowed.

    이 오류를 수정하려면 아래 발췌물에 나와 있는 대로 <Set>을 사용하여 <Add> 대신 CORS 헤더를 설정하도록 AssignMessage 정책을 수정하세요. 자세한 내용은 관련 커뮤니티 자료를 참조하세요. 

    <AssignMessage async="false" continueOnError="false" enabled="true" name="add-cors">
    <DisplayName>Add CORS</DisplayName>
    <FaultRules/>
    <Properties/>
    <Set>
        <Headers>
            <Header name="Access-Control-Allow-Origin">{request.header.origin}</Header>
            <Header name="Access-Control-Allow-Headers">origin, x-requested-with, accept, content-type, authorization</Header>
            <Header name="Access-Control-Max-Age">3628800</Header>
            <Header name="Access-Control-Allow-Methods">GET, PUT, POST, DELETE</Header>
        </Headers>
    </Set>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="response"/>
</AssignMessage>

    오류: 요청 헤더 입력란이 허용되지 않음

    이 API 사용해 보기를 사용할 때 아래 예시와 유사한 Request header field not allowed 오류가 발생하면 CORS 정책에서 지원되는 헤더를 업데이트해야 할 수도 있습니다. 예를 들면 다음과 같습니다.

    Access to XMLHttpRequest ... has been blocked by CORS policy: Request header field
content-type is not allowed by Access-Control-Allow-Headers in preflight response

    이 예시에서는 새 API 프록시에 CORS 정책 추가 첨부에 설명된 대로 CORS AssignMessage 정책의 Access-Control-Allow-Headers 섹션에 content-type 헤더를 추가해야 합니다.

    오류: OAuth2를 사용하여 API 프록시 호출 시 액세스 거부됨

    Apigee의 OAuthV2 정책은 RFC를 준수하지 않는 특정 속성이 포함된 토큰 응답을 반환합니다. 예를 들어 정책은 RFC 준수값 Bearer가 아닌 BearerToken 값이 있는 토큰을 반환합니다. 이 API 사용해 보기를 사용할 때 이러한 잘못된 token_type 응답이 Access denied 오류로 이어질 수 있습니다.

    이 문제를 해결하려면 자바스크립트 또는 AssignMessage 정책을 만들어 정책 출력을 규정 준수 형식으로 변환하면 됩니다. 자세한 내용은 RFC를 준수하지 않는 동작을 참조하세요.