인코딩 정의 작성

온라인에서 편집하기

인코딩 정의는 특정 스키마 특성과 해당 인코딩 정보 사이에 맵을 정의합니다.

시작하기 전에

콘텐츠 정의를 구성할 때 인코딩 정의 생성 창을 실행합니다. 자세한 내용은 ‘콘텐츠 정의 편집’을 참조하십시오.

이 태스크에 대한 정보

참고:
  • 이 태스크는 OpenAPI 3.0 API 정의 구성과 관련이 있습니다. OpenAPI 2.0 API 정의를 구성하는 방법에 대한 세부사항은 OpenAPI 2.0 API 정의 편집을 참조하십시오.
  • OpenAPI 3.0 API는 DataPower Gateway (v5 compatible)가 아닌 DataPower® API Gateway에서만 지원됩니다.
  • 현재 OpenAPI 3.0 지원 제한사항에 대한 세부사항은 IBM® API Connect 의 OpenAPI 3.0 지원의 내용을 참조하십시오.

API Designer UI 애플리케이션을 사용하거나 브라우저 기반 API Manager UI를 사용하여 이 태스크를 완료할 수 있습니다.

언제든지 소스 아이콘을 클릭하면 기본 OpenAPI 소스 아이콘OpenAPI YAML 소스 파일로 바로 전환할 수 있습니다. 양식 화면으로 돌아가려면 양식 아이콘을 클릭하세요 양식 아이콘.

프로시저

  1. 다음 정보를 제공하십시오.
    • 이름: 스키마 특성의 이름입니다.
    • Content-Type: 특성을 인코딩하기 위한 Content-Type입니다. 예를 들면, application/xml; charset=utf-8, image/png, image/jpeg입니다.
    • 스타일: 특성 값이 특성 값의 유형에 따라 직렬화될 방법을 설명합니다. 다음 옵션 중 하나를 선택하십시오.
      • form : RFC6570 에서 정의된 양식 스타일 속성.
      • spaceDelimited: 공백으로 분리된 어레이 값입니다.
      • pipeDelimited: 파이프로 분리된 어레이 값입니다.
      • deepObject: 양식 특성을 사용하여 중첩 오브젝트를 렌더링하는 간단한 방법을 제공합니다.
    • Explode: 선택한 경우, 유형 array 또는 object의 특성 값은 맵의 어레이 또는 키 값 쌍의 각 값을 위한 별도의 특성을 생성합니다.
    • 'Allow Reserved ': 이 속성 값이 RFC3986 (:/?#[]@!$&'()*+,;=)에 정의된 예약된 문자를 퍼센트 인코딩 없이 포함할 수 있도록 허용할지 여부를 결정합니다.
  2. 작성을 클릭하십시오.
    인코딩 정의의 세부 정보가 표시되어 추가 편집이 가능합니다. 자세한 내용은 ‘인코딩 정의 편집’을 참조하십시오.