## 我的工单 (`my-tickets`)

用户提交、回复、关闭、评价与重开自己的工单。

鉴权: 用户 · 文档: https://www.gocdn888.com/zh/docs/api/my-tickets

### GET `/api/v2/my-tickets`

我的工单列表 · 鉴权: 用户

查询参数:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `page` | integer |  | 页码,从 1 开始。 默认: 1 |
| `page_size` | integer |  | 每页条数。 默认: 20 |
| `status` | string |  | 标签页:open 待处理(用户端为处理中)、replied 待用户确认(用户端为待您确认)、closed 已关闭;不传 = 全部。 可选值: ["open","replied","closed"] |
| `q` | string |  | 搜索:纯数字按编号精确,否则按标题子串。 |
| `category` | string |  | 按分类过滤:site 网站、cert 证书、security 安全防护、l4 四层转发、billing 套餐与账单、other 其他;逗号分隔可多选。 |
| `site_id` | integer |  | 按关联网站或转发规则的 id 过滤。 |
| `created_from` | string |  | 提交时间起(含)。 |
| `created_to` | string |  | 提交时间止(不含)。 |

```sh
curl "https://panel.example.com/api/v2/my-tickets" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/my-tickets`

提交工单 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `body` | string | 有 | 正文,最长 2000 字符。 |
| `category` | string | 有 | 分类:site 网站、cert 证书、security 安全防护、l4 四层转发、billing 套餐与账单、other 其他。 可选值: ["site","cert","security","l4","billing","other"] |
| `image_ids` | integer[] |  | 先经 POST /ticket-images 上传的图片 id,至多 5 个,须是本人上传且还没被用过的。 |
| `rel_id` | integer |  | 关联对象 id,0 = 无。 |
| `title` | string | 有 | 标题,最长 60 字符。 |
| `urgent` | boolean |  | 是否紧急。 |

```sh
curl -X POST "https://panel.example.com/api/v2/my-tickets" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### GET `/api/v2/my-tickets/{id}`

我的工单详情 · 鉴权: 用户

```sh
curl "https://panel.example.com/api/v2/my-tickets/{id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/my-tickets/{id}/close`

用户关闭 · 鉴权: 用户

```sh
curl -X POST "https://panel.example.com/api/v2/my-tickets/{id}/close" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/my-tickets/{id}/rating`

评价工单 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `note` | string |  | 评价附言,最长 500 字符。 |
| `rating` | string | 有 | 评价:good 满意、normal 一般、bad 不满意,空 = 未评。 可选值: ["","good","normal","bad"] |

```sh
curl -X POST "https://panel.example.com/api/v2/my-tickets/{id}/rating" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/my-tickets/{id}/reopen`

用户重开 · 鉴权: 用户

```sh
curl -X POST "https://panel.example.com/api/v2/my-tickets/{id}/reopen" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/my-tickets/{id}/replies`

用户回复 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `body` | string |  | 正文,最长 2000 字符。 |
| `image_ids` | integer[] |  | 先经 POST /ticket-images 上传的图片 id,至多 5 个,须是本人上传且还没被用过的。 |

```sh
curl -X POST "https://panel.example.com/api/v2/my-tickets/{id}/replies" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/my-tickets/{id}/resolve`

已解决 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `note` | string |  | 评价附言,最长 500 字符。 |
| `rating` | string |  | 评价:good 满意、normal 一般、bad 不满意,空 = 未评。 可选值: ["","good","normal","bad"] |

```sh
curl -X POST "https://panel.example.com/api/v2/my-tickets/{id}/resolve" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

我的工单对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `auto_close_at` | string |  | 自动关闭的到期时间:仅「待用户确认」且开了自动关闭时有值(答复时间 + 设置天数,改设置后按新值);否则为空。列表药丸「N 天后自动关闭」据此算。 |
| `body` | string | 有 | 正文,最长 2000 字符。 |
| `can_rate` | boolean |  | 仅用户端:已关闭或待确认、没评价过且评价开关开着(待确认单据此决定「已解决」弹框出不出评价区)。 |
| `can_reopen` | boolean |  | 仅用户端:已关闭且还在重开期限内。 |
| `category` | string |  | 分类:site 网站、cert 证书、security 安全防护、l4 四层转发、billing 套餐与账单、other 其他。 可选值: ["site","cert","security","l4","billing","other"] |
| `close_reason` | string |  | 关闭原因:user 用户、staff 客服、timeout 超时自动关闭;未关闭为空。 可选值: ["","user","staff","timeout"] |
| `closed_at` | string |  | 关闭时间;未关闭为空。 |
| `created_at` | string |  | 创建时间 |
| `created_by_admin` | boolean |  | 是否管理员代用户提交;仅管理端有值。 |
| `id` | integer |  | 工单编号。 |
| `image_ids` | integer[] |  | 先经 POST /ticket-images 上传的图片 id,至多 5 个,须是本人上传且还没被用过的。 |
| `last_at` | string |  | 最后一次有消息或状态变化的时间。 |
| `last_kind` | string |  | 最后一条消息的发送方:user 用户、staff 客服,空 = 没有消息。用户端列表据此给客服消息加「客服:」前缀。 可选值: ["","user","staff"] |
| `last_snippet` | string |  | 最后一条客服/用户消息的摘要(去换行折空白,最长 80 字符,超出以省略号结尾);内部备注与系统行不算;没有消息为空。 |
| `messages` | TicketMessage[] |  | 消息串,按 id 升序;用户端没有 note。 |
| `msg_count` | integer |  | 客服/用户消息条数(含提交时的首条描述,不含内部备注与系统行)。 |
| `new_count` | integer |  | read_pos 之后对方新发的条数。 |
| `note` | string |  | 评价附言,最长 500 字符。 |
| `rating` | string |  | 评价:good 满意、normal 一般、bad 不满意,空 = 未评。 可选值: ["","good","normal","bad"] |
| `rating_enabled` | boolean |  | 仅用户端:工单设置里的评价开关(关着时已解决弹框不显示评价区)。 |
| `rating_note` | string |  | 评价附言。 |
| `read_pos` | integer |  | 本端打开前的已读位置(消息 id);新消息分隔线画在它之后。 |
| `rel_id` | integer |  | 关联对象 id,0 = 无。 |
| `rel_name` | string |  | 关联对象名称(提交时的快照)。 |
| `rel_type` | string |  | 关联对象类型:site 网站、stream 转发规则,空 = 无。 可选值: ["","site","stream"] |
| `reopen_until` | string |  | 仅用户端:已关闭时,可重开的截止时间。 |
| `status` | string |  | open 待客服处理、replied 等用户确认、closed 已关闭。 可选值: ["open","replied","closed"] |
| `tenant_id` | integer |  | 提交用户(租户)id。 |
| `title` | string |  | 标题,最长 60 字符。 |
| `unread` | integer |  | 对方新发、本端还没读的消息条数。 |
| `urgent` | boolean |  | 是否紧急。 |
| `user` | object |  | 提交用户信息;仅管理端有。 |
| `user_name` | string |  | 提交用户名;只管理端有值。 |
