> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 네이티브 스타일 조회



## OpenAPI

````yaml /openapi/adm.openapi.ko-dev.json get /api/manager/native-styles/{sid}
openapi: 3.1.0
info:
  description: >-
    ## 소개

    Data Management API는 광고 및 추천 시스템이 활용하는 **다양한 데이터를** 종합적으로 관리해, Decision API가
    정확하고 효율적으로 작동할 수 있도록 돕습니다.


    캠페인이나 지면을 신규 등록하고 수정·삭제하는 것은 물론, **로그 및 통계 분석을** 통해 시스템 운영에 필요한 인사이트를 확보합니다.
    이렇게 확보된 데이터와 통계는 Decision API에서 최적화된 광고·콘텐츠를 결정하는 데 활용되며, 전체 광고·추천 시스템의 성능
    향상에 이바지합니다.
  title: 데이터 관리 API
  version: dev
servers: []
security: []
tags:
  - description: 인증 엔드포인트. 모든 역할(admin/operator/advertiser)이 로그인·토큰 갱신·본인 자격 증명 관리에 사용합니다.
    name: 인증
  - description: >-
      광고주 계정 관리. 운영자·관리자가 광고주를 온보딩하고 예산을 관리하며 계정을 비활성화합니다. 광고주는 본인 프로필과 잔액만 조회할
      수 있습니다.
    name: 광고주
  - description: >-
      내부 사용자(운영자/관리자) 계정 관리. 관리자 전용. 운영자 계정 생성, 역할 변경, 활성화 상태 토글, 계정 영구 삭제를
      다룹니다.
    name: 사용자
  - description: >-
      광고 단위 관리. 광고 단위와 관련 리소스를 관리합니다. 광고 단위는 code와 상위 경로에서 파생된 계층 경로 구조로 구성됩니다.
      admin·operator만 접근 가능하며 광고주는 원천 인벤토리에 접근할 수 없습니다.
    name: 광고 단위
  - description: 광고 카탈로그 관리. 광고 카탈로그 CRUD와 공유 링크를 통한 공개 조회를 제공합니다.
    name: 광고 카탈로그
  - description: 수요 파트너(광고 소스) 관리. 광고 단위에 수요를 공급하는 외부 광고 소스를 CRUD합니다.
    name: 수요 파트너
  - description: 게재 할당 관리. 광고 항목을 광고 단위 등 게재 대상에 연결합니다. CRUD, 상태별 카운트, 단건 조회를 제공합니다.
    name: 게재 할당
  - description: 연관 상품 풀(관리자). 추천 파이프라인에서 사용하는 연관 상품 풀의 일괄 저장/삭제 및 조회.
    name: 연관 상품 풀
  - description: 커스텀 타게팅 세그먼트 관리. 커스텀 타게팅 세그먼트의 CRUD 및 일괄 작업.
    name: 커스텀 타게팅 세그먼트
  - description: 감사 로그 조회. 관리 작업에 대한 시스템 감사 로그를 조회합니다.
    name: 감사 로그
  - description: 소재 차단 목록. 소재를 차단/차단 해제해 게재에서 제외합니다.
    name: 차단 소재
  - description: 카탈로그 항목 관리. 상품/데이터 카탈로그 항목을 조회·수정합니다.
    name: 카탈로그
  - description: 광고 소재 관리. 운영자·관리자가 소재를 관리하며 광고주는 본인 소재만 조회합니다. 연결된 LICA가 있으면 삭제가 차단됩니다.
    name: 소재
  - description: 대시보드 집계. 콘솔 대시보드용 요약·인벤토리·광고 항목 지표 롤업.
    name: 대시보드
  - description: 실험 관리. A/B·최적화 실험의 CRUD.
    name: 실험
  - description: 외부 소재 조회. 외부 수요 소스에서 수집된 소재를 읽기 전용으로 조회합니다.
    name: 외부 소재
  - description: 외부 연동 관리. 연동 소스(외부 데이터/서빙 커넥터)를 관리하고 연결을 테스트하며, 민감 설정이 마스킹된 공개 설정을 조회합니다.
    name: 연동
  - description: >-
      소재-광고 항목 연결(LICA). 소재를 광고 항목에 연결하며, 일괄 생성/삭제(최대 100, 부분 실패 허용)와 대시보드 카운트를
      제공합니다.
    name: 소재-광고 항목 연결(LICA)
  - description: 라이선스 정보. 사용 가능한 라이선스 기능과 사용량 지표를 조회합니다.
    name: 라이선스
  - description: >-
      광고 항목 관리. 생성·수정·삭제, 일괄 작업(최대 100, 부분 실패 허용), 상태 전환을 다룹니다. 광고 항목은 상위 주문
      아래에서 예산·목표·일정·타게팅을 정의합니다.
    name: 광고 항목
  - description: 미디어 라이브러리. 소재에 쓰이는 미디어 파일을 조회·업로드·삭제합니다.
    name: 미디어 라이브러리
  - description: 지표 조회 엔드포인트. 광고 단위·소재·광고 항목 등 엔티티의 집계 지표를 조회합니다.
    name: 지표
  - description: >-
      주문 관리. 운영자·관리자가 예산 단위로 광고 항목을 묶는 주문을 생성·관리하며, 광고주는 본인 주문을 조회합니다. 일괄 작업(최대
      100)과 draft 상태 삭제 규칙을 포함합니다.
    name: 주문
  - description: 게재 위치 관리. 게재 위치는 광고 단위를 게재 표면에 매핑합니다. CRUD와 게재 위치에 연결된 광고 단위 교체를 제공합니다.
    name: 게재 위치
  - description: 시스템 설정. 사이트 로고·Public URL·TLS·액세스 토큰 재생성을 포함한 시스템 구성을 조회·수정합니다.
    name: 설정
  - description: 시스템 리소스. 사이트 로고 등 공개 정적 리소스.
    name: 시스템
  - description: 개발자/운영용 제어 엔드포인트. 저수준 ext 변경과 헬스 체크. 일반 API 소비자가 아닌 내부 운영용입니다.
    name: 개발자/운영
  - description: 운영용 게재 할당 제어. 게재 할당 ext/상태 강제 변경(관리자 전용).
    name: 개발자/게재 할당 제어
  - description: 광고 서빙 모니터링(운영). 광고 서빙 현황·광고 단위 모니터링 이력·알림을 조회합니다.
    name: 개발자/모니터링
  - description: 내부 헬스/프로브 엔드포인트.
    name: 내부
  - description: '특정 리소스에 속하지 않는 매니저 공통 유틸리티 엔드포인트(예: 서비스 헬스).'
    name: 매니저(공통)
  - description: 광고 단위, 네이티브 포맷 및 네이티브 스타일 간의 매핑을 관리합니다.
    name: Ad Unit Native Style
  - description: 커스텀 타게팅 키와 활성화 상태를 관리하고 일괄 작업을 수행합니다.
    name: Custom Targeting Key
  - description: 커스텀 타게팅 키에 속한 값과 활성화 상태를 관리하고 일괄 작업을 수행합니다.
    name: Custom Targeting Value
  - description: 네이티브 포맷과 각 포맷을 구성하는 필드를 관리합니다.
    name: Native Format
  - description: 네이티브 스타일에 사용할 수 있는 템플릿을 조회합니다.
    name: Native Style Template
  - description: 네이티브 렌더링 스타일을 관리합니다.
    name: Native Style
paths:
  /api/manager/native-styles/{sid}:
    get:
      tags:
        - Native Style
      summary: 네이티브 스타일 조회
      operationId: handle_get_native_style_api_manager_native_styles__sid__get
      parameters:
        - in: path
          name: sid
          required: true
          schema:
            format: uuid
            title: Sid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NativeStyleDetailResponse'
          description: 성공 응답
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: 권한 없음
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: 찾을 수 없음
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: 유효성 검사 오류
      security:
        - HTTPBearer: []
components:
  schemas:
    NativeStyleDetailResponse:
      properties:
        created_at:
          format: date-time
          title: Created At
          type: string
        css:
          description: 이 스타일의 CSS 스타일시트.
          title: Css
          type: string
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: 스타일 설명(선택 사항).
          title: Description
        editor_config:
          anyOf:
            - {}
            - type: 'null'
          description: 프론트엔드 가이드형 에디터 상태입니다. 백엔드는 해석하지 않으며, 서빙은 html/css를 사용합니다.
          title: Editor Config
        editor_type:
          $ref: '#/components/schemas/NativeEditorType'
          default: guided
          description: '에디터 유형: GUIDED(폼 기반) 또는 CODE(HTML/CSS 직접 작성).'
        format_id:
          description: 이 스타일이 속하는 NativeFormat ID.
          format: uuid
          title: Format Id
          type: string
        format_name:
          description: 이 스타일이 속하는 NativeFormat의 이름.
          title: Format Name
          type: string
        format_type:
          $ref: '#/components/schemas/NativeFormatType'
          description: 이 스타일이 속하는 NativeFormat의 타입.
        height:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          description: 광고 단위의 고정 높이(픽셀).
          title: Height
        html:
          description: HTML 템플릿 문자열. 변수 플레이스홀더는 NativeFormatVariable.name과 일치합니다.
          title: Html
          type: string
        id:
          description: 고유 식별자(UUID v4).
          format: uuid
          title: Id
          type: string
        is_fluid:
          default: false
          description: 컨테이너 너비에 맞게 스타일을 늘릴지 여부.
          title: Is Fluid
          type: boolean
        layout_type:
          anyOf:
            - $ref: '#/components/schemas/NativeLayoutType'
            - type: 'null'
          description: 적용된 NativeStyleTemplate의 레이아웃 타입(있는 경우).
        name:
          description: 스타일의 표시 이름.
          title: Name
          type: string
        'no':
          anyOf:
            - type: integer
            - type: 'null'
          title: 'No'
        owner_id:
          description: 스타일을 소유한 오퍼레이터 ID.
          format: uuid
          title: Owner Id
          type: string
        owner_name:
          anyOf:
            - type: string
            - type: 'null'
          description: 스타일 소유자 이름
          title: Owner Name
        status:
          $ref: '#/components/schemas/NativeStyleStatus'
          default: inactive
          description: 스타일의 운영 상태.
        template_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          description: 이 스타일에 적용된 NativeStyleTemplate ID.
          title: Template Id
        updated_at:
          format: date-time
          title: Updated At
          type: string
        width:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          description: 광고 단위의 고정 너비(픽셀). is_fluid가 true이면 무시됩니다.
          title: Width
      required:
        - id
        - created_at
        - updated_at
        - css
        - format_id
        - html
        - name
        - owner_id
        - format_name
        - format_type
      title: NativeStyleDetailResponse
      type: object
    HTTPExceptionResponse:
      properties:
        detail:
          description: 오류에 대한 상세 설명
          title: Detail
          type: string
      required:
        - detail
      title: HTTPExceptionResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    NativeEditorType:
      enum:
        - guided
        - code
      title: NativeEditorType
      type: string
    NativeFormatType:
      enum:
        - system_defined
        - user_defined
      title: NativeFormatType
      type: string
    NativeLayoutType:
      enum:
        - image_top
        - image_bottom
        - image_left
        - image_right
      title: NativeLayoutType
      type: string
    NativeStyleStatus:
      enum:
        - active
        - inactive
      title: NativeStyleStatus
      type: string
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    HTTPBearer:
      description: 'Bearer 인증. 액세스 토큰을 `Authorization: Bearer <token>` 헤더로 전달합니다.'
      scheme: bearer
      type: http

````