수명 주기

수명 주기 엔드포인트는 Journey를 상태 간에 이동시킵니다. 요청 본문에 Journey의 Journey ID를 uuid로 전달합니다. 호출은 업데이트된 journey object를 반환합니다.

Journey는 항상 다음 상태 중 하나입니다:

상태	의미
`STATUS_DRAFT`	편집 중입니다. 사용자를 처리하지 않습니다.
`STATUS_RUNNING`	활성 상태이며 사용자를 처리 중입니다.
`STATUS_PAUSED`	일시적으로 중단되었으며 재개할 수 있습니다.
`STATUS_FINISHED`	중지되었으며 더 이상 사용자를 처리하지 않습니다. 편집을 재개하기 위해 일시 중지하거나 보관할 수 있습니다.
`STATUS_ARCHIVED`	저장을 위해 보관되었습니다. 최종 상태 — 이 엔드포인트를 통해 다시 활성화할 수 없습니다.

엔드포인트

모든 수명 주기 호출은 동일한 요청 본문인 uuid로 전달되는 Journey ID를 사용합니다. 경로만 다릅니다:

작업	메서드 및 경로	결과 상태
시작	`POST /api/v3/journeygateway/start`	`STATUS_RUNNING`
일시 중지	`POST /api/v3/journeygateway/pause`	`STATUS_PAUSED`
완료	`POST /api/v3/journeygateway/finish`	`STATUS_FINISHED`
보관	`POST /api/v3/journeygateway/archive`	`STATUS_ARCHIVED`

유효한 전환

시작 상태	종료 상태	방법
`STATUS_DRAFT`	`STATUS_RUNNING`	시작
`STATUS_RUNNING`	`STATUS_PAUSED`	일시 중지
`STATUS_PAUSED`	`STATUS_RUNNING`	시작
`STATUS_RUNNING`	`STATUS_FINISHED`	완료
`STATUS_PAUSED`	`STATUS_FINISHED`	완료
`STATUS_FINISHED`	`STATUS_PAUSED`	일시 중지
`STATUS_FINISHED`	`STATUS_ARCHIVED`	보관

보관은 이 표에서 수명 주기 엔드포인트를 통해 되돌릴 수 없는 유일한 단계입니다.

요청

필드	필수	유형	설명
`uuid`	예	string	전환할 Journey의 Journey ID입니다.

{ "uuid": "11111111-2222-3333-4444-555555555555" }

API는 전환하기 전에 현재 상태를 확인합니다 — 위 표를 참조하십시오. 예를 들어, 보관에는 역전환이 없으므로 보관된 Journey를 시작하면 오류가 반환됩니다.

요청 예시

Journey 시작하기

curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/start \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'

Journey 일시 중지하기

curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/pause \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'

응답

업데이트된 journey object(info, points, comments)를 반환합니다. info.status 필드는 새로운 상태를 반영합니다.

응답 예시

{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "환영 시리즈",
    "status": "STATUS_RUNNING",
    "created_at": "2026-05-01T09:00:00Z",
    "updated_at": "2026-06-17T12:00:00Z",
    "params": { "application_code": "XXXXX-XXXXX" },
    "campaign_type": "TriggerBased"
  },
  "points": [],
  "comments": []
}

전체 필드 목록은 journey object 참조를 참조하십시오.