> ## 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/decision.api.ko-dev.json post /app/api/cache/placements
openapi: 3.1.0
info:
  contact:
    email: a2support@aiderx.io
    name: A2 Support
    url: https://aiderx.io
  description: |-
    ### 소개
    Decision API는 사용자 요청 또는 컨텍스트 정보를 바탕으로 광고나 콘텐츠를 실시간으로 선택하고 배포합니다.
    빠른 응답과 동적 기능을 통해 최적의 광고 또는 추천을 제공하여 사용자가 가능한 가장 높은 가치를 얻도록 합니다.

    다양한 알고리즘, 머신러닝 모델 및 규칙 기반 로직을 적용할 수 있어 시스템이 끊임없이 변하는 조건에 유연하게 적응할 수 있습니다.
  title: Decision API
  version: dev
  x-logo:
    altText: A2 Logo
    url: >-
      https://cdn.prod.website-files.com/668de9e1f25ab5675d87758d/6690cf1bdce95af5e3522c25_a2_logo_800_250.png
servers: []
security: []
tags:
  - description: 광고 요청, 캐시 설정 및 광고 제공 모듈의 기타 매개변수를 구성하기 위한 API입니다.
    name: Ad Serving
  - description: 추천 요청을 위한 API
    name: Recommendation Serving
  - description: >-
      광고 제공 서버의 캐시를 조작하기 위한 API입니다.


      ### **중요**

      Serving 서버의 광고 또는 추천 관련 캐시 데이터를 직접 조작하는 경우 Ad Manager에서 광고 또는 추천 데이터를 함께
      수정하지 않는 것을 **강력히 권장합니다.**


      대신 모든 광고 또는 추천 데이터 변경은 Ad Manager API를 통해 처리하는 것을 **권장합니다.**

      Serving 서버에서 변경한 내용은 Ad Manager에 반영되지 않으므로 **데이터 무결성**이 손상될 수 있습니다.
    name: Cache Management
  - description: 광고 서빙 서버 설정 API
    name: Configuration
  - description: 광고 또는 추천과 관련된 전환, 노출 및 클릭 로그를 수신하는 API입니다.
    name: Ad Log
paths:
  /app/api/cache/placements:
    post:
      tags:
        - Cache Management
      summary: 지면 등록
      description: |-
        캐시에 지면 정보를 저장합니다.
        지면 메타데이터를 기반으로 제공 로직을 갱신하는 데 사용합니다.
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/Placement'
              type: array
        required: true
      responses:
        '204':
          description: 성공
        '400':
          content:
            text/plain:
              schema:
                type: string
          description: 요청 본문을 JSON으로 파싱하지 못했습니다.
        '415':
          content:
            text/plain:
              schema:
                type: string
          description: '`Content-Type: application/json`인 요청이 필요합니다.'
        '422':
          content:
            text/plain:
              schema:
                type: string
          description: JSON 본문을 대상 형식으로 역직렬화하지 못했습니다.
        '500':
          description: 내부 서버 오류.
      security:
        - '': []
components:
  schemas:
    Placement:
      description: 인벤토리 패키징을 위한 광고 유닛 그룹입니다.
      properties:
        ad_unit_ids:
          default: []
          description: 연결된 광고 유닛 ID 목록입니다.
          items:
            format: uuid
            type: string
          maxItems: 1000
          type: array
        created_at:
          description: 지면이 생성된 일시
          format: date-time
          type: string
        created_by:
          description: 생성한 사용자의 ID입니다.
          format: uuid
          type: string
        description:
          description: 지면의 선택적 설명입니다.
          type:
            - string
            - 'null'
        ext:
          description: 추가 지면별 데이터를 위한 확장 필드입니다.
        id:
          description: 지면의 고유 식별자(UUID v4)입니다.
          format: uuid
          type: string
        name:
          description: 사람이 읽을 수 있는 지면 이름입니다.
          type: string
        status:
          allOf:
            - $ref: '#/components/schemas/PlacementStatus'
          default: INACTIVE
          description: 지면의 운영 상태입니다. 기본값은 `Inactive`입니다.
      required:
        - id
        - name
        - created_by
        - created_at
      type: object
    PlacementStatus:
      description: 지면의 운영 상태입니다.
      oneOf:
        - const: ACTIVE
          description: 지면이 활성 상태이며 타기팅에 사용할 수 있습니다.
          type: string
        - const: INACTIVE
          description: 지면이 비활성 상태이며 타기팅에 사용할 수 없습니다.
          type: string
        - const: ARCHIVED
          description: 지면이 보관되어 수정하거나 타기팅할 수 없습니다.
          type: string

````