Skip to main content
POST
소재 미디어 파일 업로드

인증

Authorization
string
header
필수

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

경로 매개변수

crid
string<uuid>
필수

본문

multipart/form-data
file
file
필수

업로드할 미디어 파일. 허용 형식: 이미지(PNG, JPEG, GIF) 또는 비디오(MP4).

응답

성공 응답

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