캠페인 상태 액션 (시작·일시정지·재개·종료)

PUT

/api/core/organization/{organizationId}/campaign/{campaignId}/{action}

curl --request PUT \
  --url https://www.easterad.com/api/core/organization/example/campaign/example/CAMPAIGN_ACTION_START \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "reason": "example" }'

• Production

Authorizations

• bearerAuth

Parameters

Path Parameters

organizationId

required

string

campaignId

required

string

action

required

Any of:

string

string

Allowed value: CAMPAIGN_ACTION_START

string

string

Allowed value: CAMPAIGN_ACTION_PAUSE

string

string

Allowed value: CAMPAIGN_ACTION_RESTART

string

string

Allowed value: CAMPAIGN_ACTION_TERMINATE

Request Body^required

Media typeapplication/json

object

reason

string

<= 500 characters

Example^generated

{
  "reason": "example"
}

Responses

200

성공

Media typeapplication/json

object

_id

required

string

organizationId

required

string

campaignId

required

string

action

required

Any of:

string

string

Allowed value: CAMPAIGN_ACTION_START

string

string

Allowed value: CAMPAIGN_ACTION_PAUSE

string

string

Allowed value: CAMPAIGN_ACTION_RESTART

string

string

Allowed value: CAMPAIGN_ACTION_TERMINATE

string

string

Allowed value: CAMPAIGN_ACTION_APPROVE

string

string

Allowed value: CAMPAIGN_ACTION_REJECT

statusFrom

required

Any of:

string

string

Allowed value: CAMPAIGN_STATUS_PENDING

string

string

Allowed value: CAMPAIGN_STATUS_STARTING

string

string

Allowed value: CAMPAIGN_STATUS_RUNNING

string

string

Allowed value: CAMPAIGN_STATUS_PAUSING

string

string

Allowed value: CAMPAIGN_STATUS_PAUSED

string

string

Allowed value: CAMPAIGN_STATUS_TERMINATING

string

string

Allowed value: CAMPAIGN_STATUS_TERMINATED

statusTo

required

Any of:

string

string

Allowed value: CAMPAIGN_STATUS_PENDING

string

string

Allowed value: CAMPAIGN_STATUS_STARTING

string

string

Allowed value: CAMPAIGN_STATUS_RUNNING

string

string

Allowed value: CAMPAIGN_STATUS_PAUSING

string

string

Allowed value: CAMPAIGN_STATUS_PAUSED

string

string

Allowed value: CAMPAIGN_STATUS_TERMINATING

string

string

Allowed value: CAMPAIGN_STATUS_TERMINATED

actorId

string

reason

string

createdAt

required

string

/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/

Example

{
  "action": "CAMPAIGN_ACTION_START",
  "statusFrom": "CAMPAIGN_STATUS_PENDING",
  "statusTo": "CAMPAIGN_STATUS_PENDING"
}

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"
}