Skip to main content
POST
소재 생성

인증

Authorization
string
header
필수

Bearer 인증. 액세스 토큰을 Authorization: Bearer <token> 헤더로 전달합니다.

본문

application/json
name
string
필수
Minimum string length: 1
type
enum<string>
필수
사용 가능한 옵션:
banner,
video,
native
advertiser_domain
string | null

이 소재를 사용하는 광고주 도메인.

advertiser_id
string<uuid> | null

이 소재를 사용하는 광고주 ID.

banner
BannerInput · object | null

쓰기/입력용 DTO — write 시점에만 URL 스킴을 검증한다.

description
string | null

소재의 선택적 설명.

end_date
string<date-time> | null
ext
any
기본값:{}

소재 확장 데이터

height
integer
기본값:0
필수 범위: x >= 0
native
NativeInput · object | null

쓰기/입력용 DTO — write 시점에만 URL 스킴을 검증한다.

start_date
string<date-time> | null
status
enum<string>
기본값:inactive

소재 상태.

사용 가능한 옵션:
inactive,
active
video
Video · object | null

비디오 소재 콘텐츠.

width
integer
기본값:0
필수 범위: x >= 0

응답

성공 응답

created_at
string<date-time>
필수
height
integer
필수

소재 높이 (픽셀).

필수 범위: x >= 0
id
string<uuid>
필수

소재 고유 식별자 (UUID v7).

name
string
필수

소재 이름.

owner_id
string<uuid>
필수

소재를 생성한 관리자/운영자 사용자 ID.

type
enum<string>
필수

소재 유형 (예: "banner", "video", "native").

사용 가능한 옵션:
banner,
video,
native
updated_at
string<date-time>
필수
width
integer
필수

소재 너비 (픽셀).

필수 범위: x >= 0
advertiser_domain
string | null

이 소재를 사용하는 광고주 도메인.

advertiser_id
string<uuid> | null

이 소재를 사용하는 광고주 ID.

banner
BannerResponse · object | null

읽기/응답용 DTO — 저장된 AdCOM Banner를 그대로 노출. 검증 없음.

description
string | null

소재의 선택적 설명.

end_date
string<date-time> | null
ext
any
기본값:{}

소재 확장 데이터

native
Native · object | null

네이티브 소재 콘텐츠.

no
integer | null
start_date
string<date-time> | null
status
enum<string>
기본값:inactive

소재 상태.

사용 가능한 옵션:
inactive,
active
video
Video · object | null