# 生命周期

生命周期端点用于在不同状态之间移动一个 Journey。在请求体中将 Journey 的 [Journey ID](/zh/developer/api-reference/api-identifiers/#journey-id) 作为 `uuid` 传递。该调用会返回更新后的 [Journey 对象](/zh/developer/api-reference/customer-journey-api/journey-object/)。

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

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

## 端点

所有生命周期调用都使用相同的请求体：将 [Journey ID](/zh/developer/api-reference/api-identifiers/#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](/zh/developer/api-reference/api-identifiers/#journey-id)。 |

```json title="请求体"
{ "uuid": "11111111-2222-3333-4444-555555555555" }
```

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

<Aside type="note">
要在一个调用中启动 Journey **并** 应用待处理的编辑，请使用[更新并恢复](/zh/developer/api-reference/customer-journey-api/create-update/#update-and-resume) 而不是 `start`。
</Aside>

### 请求示例

#### 启动一个 Journey

```bash
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

```bash
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 对象](/zh/developer/api-reference/customer-journey-api/journey-object/)：`info`、`points` 和 `comments`。`info.status` 字段反映了新的状态。

### 响应示例
```json
{
  "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 对象参考](/zh/developer/api-reference/customer-journey-api/journey-object/)。

## 相关内容

<CardGrid>
  <LinkCard title="创建和更新" href="/developer/api-reference/customer-journey-api/create-update/" />
  <LinkCard title="通过 API 启动" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="Journey 对象" href="/developer/api-reference/customer-journey-api/journey-object/" />
</CardGrid>