소재 원본 접수

POST

/api/core/organization/{organizationId}/ad/assets

curl --request POST \
  --url https://www.easterad.com/api/core/organization/example/ad/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@file \
  --form productType=1

• Production

202는 접수 성공입니다. READY가 될 때까지 statusPath를 조회하세요. 원본 규격은 소재 요건 문서를 참고하세요.

Authorizations

• bearerAuth

Parameters

Path Parameters

organizationId

required

string

Request Body^required

Media typemultipart/form-data

object

file

required

정적 JPEG·PNG·WebP 1 MiB 이하 또는 MP4·MOV 50 MiB 이하. 파일 하나만 접수합니다.

string format: binary

productType

required

1: 디스플레이 이미지, 2: H5 전면, 3: H5 리워드, 4: H5 배너

string

Allowed values: 1 2 3 4

Responses

202

접수 성공. 준비 완료 여부는 status를 확인합니다.

Media typeapplication/json

object

assetId

string

status

string

/^(QUEUED|PROCESSING|READY|FAILED)$/

statusPath

string

result

object

url

string

mime

string

width

number

height

number

aspectRatio

number

durationSec

number

fileSize

number

errorReason

string

errorMessage

string

retryable

boolean

Example^generated

{
  "assetId": "example",
  "status": "example",
  "statusPath": "example",
  "result": {
    "url": "example",
    "mime": "example",
    "width": 1,
    "height": 1,
    "aspectRatio": 1,
    "durationSec": 1,
    "fileSize": 1
  },
  "errorReason": "example",
  "errorMessage": "example",
  "retryable": true
}

default

접수 실패

Media typeapplication/json

object

statusCode

required

number

code

required

BadRequest | Unauthorized | Forbidden | NotFound | Conflict | TooManyRequests | InternalServerError | ServiceUnavailable

string

message

required

string

reason

선택 상세 사유. 예: CREATIVE_NOT_READY

string

assetId

관련 소재 ID (선택)

string

Example^generated

{
  "statusCode": 1,
  "code": "example",
  "message": "example",
  "reason": "example",
  "assetId": "example"
}