生命周期

生命周期端点用于在不同状态之间移动一个 Journey。在请求体中将 Journey 的 Journey ID 作为 uuid 传递。该调用会返回更新后的 Journey 对象。

一个 Journey 始终处于以下状态之一：

状态	含义
`STATUS_DRAFT`	正在编辑。不处理用户。
`STATUS_RUNNING`	活跃，正在处理用户。
`STATUS_PAUSED`	暂时停止，可以恢复。
`STATUS_FINISHED`	已完成，不再处理用户。
`STATUS_ARCHIVED`	已归档以供存储。

端点

所有生命周期调用都使用相同的请求体：将 Journey ID 作为 uuid 传递。它们仅在路径上有所不同：

操作	方法和路径	最终状态
启动	`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/draft`	`STATUS_DRAFT`
归档	`POST /api/v3/journeygateway/archive`	`STATUS_ARCHIVED`

请求

字段	是否必需	类型	描述
`uuid`	是	string	要转换状态的 Journey 的 Journey ID。

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

API 会在转换状态前验证当前状态。例如，启动一个已经完成的 Journey，或暂停一个未在运行的 Journey，都会返回错误。

请求示例

启动一个 Journey

curl -X POST https://journey.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.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 对象：info、points 和 comments。info.status 字段反映了新的状态。

响应示例

{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "Welcome series",
    "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 对象参考。