# 查询与刷新任务

<a id="tasks"></a>

<a id="查询任务进度"></a>

## 查询任务进度

详情、刷新与历史

<a id="endpoint-task"></a>

<a id="任务详情"></a>

### 任务详情

GET `/v1/apps/chatgpt-refund/tasks/{id}` API Key

读取本站已记录的任务状态和费用结算结果。需要最新进度时调用刷新接口。

<a id="请求参数-2"></a>

#### 请求参数

 **id**  · path · string · 必填

提交批次返回的本站任务编号 tasks\[\].id。

<a id="响应字段说明-3"></a>

### 响应字段说明

 **id / batch\_id**  · string

本站任务编号与批次编号。后续查询使用 id。

 **key\_id**  · string

创建任务时使用的本站 API Key 编号；网页创建的任务为空。

 **account**  · string

脱敏邮箱；尚未确认时为“正在确认账号”。任务顺序不保证与输入账号顺序相同，不要按数组位置匹配账号。

 **fee**  · decimal string

单个任务的平台服务费，单位为本站积分，最多八位小数。不是订阅退款金额。

 **status**  · string

submitting、queued、processing、awaiting\_otp、unknown、succeeded、failed、cancelled 或 skipped。

 **progress / requires\_otp**  · integer / boolean

进度 0–100；requires\_otp=true 或 status=awaiting\_otp 时可提交邮箱验证码。

 **settled**  · boolean

是否完成平台服务费结算。成功确认消费；失败、取消或未受理退回预留积分。

 **failure\_code**  · string

安全的错误分类，正常时为空；例如 UPSTREAM\_UNCERTAIN、PROCESSING\_FAILED、MANUAL\_RECONCILIATION。

 **created\_at / updated\_at**  · date-time

ISO 8601 格式的创建和最近更新时间。

只能访问当前本站账户的任务，包含网页与 API 创建的任务。不存在或属于其他账户的任务统一返回 404。

调用示例请求与响应分开查看

<a id="curl-请求-3"></a>

### cURL 请求

```bash
curl 'https://y.junlistudio.com/v1/apps/chatgpt-refund/tasks/TASK_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

<a id="响应-json-3"></a>

### 响应 JSON

```json
{
  "id": "TASK_ID",
  "batch_id": "BATCH_ID",
  "key_id": "KEY_ID",
  "account": "al***@example.com",
  "fee": "7.12345678",
  "status": "processing",
  "progress": 65,
  "requires_otp": false,
  "failure_code": "",
  "settled": false,
  "created_at": "2026-10-12T08:00:00Z",
  "updated_at": "2026-10-12T08:01:00Z"
}
```

将占位值替换为你的数据 · 示例不发起真实请求

金额、时间与版本均为结构示例，以真实接口返回为准。

<a id="endpoint-refresh"></a>

<a id="刷新任务"></a>

### 刷新任务

POST `/v1/apps/chatgpt-refund/tasks/{id}/refresh` API Key

查询任务的最新状态，结果明确后自动结算对应的平台服务费。无需请求体。

<a id="请求字段-2"></a>

#### 请求字段

 **id**  · path · string · 必填

提交批次返回的本站任务编号 tasks\[\].id。

<a id="响应字段说明-4"></a>

### 响应字段说明

 **id / batch\_id**  · string

本站任务编号与批次编号。后续查询使用 id。

 **key\_id**  · string

创建任务时使用的本站 API Key 编号；网页创建的任务为空。

 **account**  · string

脱敏邮箱；尚未确认时为“正在确认账号”。任务顺序不保证与输入账号顺序相同，不要按数组位置匹配账号。

 **fee**  · decimal string

单个任务的平台服务费，单位为本站积分，最多八位小数。不是订阅退款金额。

 **status**  · string

submitting、queued、processing、awaiting\_otp、unknown、succeeded、failed、cancelled 或 skipped。

 **progress / requires\_otp**  · integer / boolean

进度 0–100；requires\_otp=true 或 status=awaiting\_otp 时可提交邮箱验证码。

 **settled**  · boolean

是否完成平台服务费结算。成功确认消费；失败、取消或未受理退回预留积分。

 **failure\_code**  · string

安全的错误分类，正常时为空；例如 UPSTREAM\_UNCERTAIN、PROCESSING\_FAILED、MANUAL\_RECONCILIATION。

 **created\_at / updated\_at**  · date-time

ISO 8601 格式的创建和最近更新时间。

建议至少间隔 5 秒；服务端会合并短时间的查询。settled=true 后停止轮询；unknown 请联系管理员核实，不要重复创建批次。

调用示例请求与响应分开查看

<a id="curl-请求-4"></a>

### cURL 请求

```bash
curl -X POST 'https://y.junlistudio.com/v1/apps/chatgpt-refund/tasks/TASK_ID/refresh' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

<a id="响应-json-4"></a>

### 响应 JSON

```json
{
  "id": "TASK_ID",
  "batch_id": "BATCH_ID",
  "key_id": "KEY_ID",
  "account": "al***@example.com",
  "fee": "7.12345678",
  "status": "processing",
  "progress": 65,
  "requires_otp": false,
  "failure_code": "",
  "settled": false,
  "created_at": "2026-10-12T08:00:00Z",
  "updated_at": "2026-10-12T08:01:00Z"
}
```

将占位值替换为你的数据 · 示例不发起真实请求

金额、时间与版本均为结构示例，以真实接口返回为准。

<a id="endpoint-history"></a>

<a id="任务历史"></a>

### 任务历史

GET `/v1/apps/chatgpt-refund/tasks` API Key

按创建时间倒序分页读取当前账户的任务，可按状态筛选。

<a id="请求参数-3"></a>

#### 请求参数

 **page**  · integer · 可选

默认 1，范围 1–100000，每页 20 条。

 **status**  · string · 可选

可选任务状态见任务详情 status；省略返回全部状态。

<a id="响应字段说明-5"></a>

### 响应字段说明

 **items / total / page**  · array / integer / integer

当前页任务、总条数与当前页码。items 每项与任务详情一致。

根据 batch\_id 关联同批次任务；完整账号凭据、内部处理信息不会返回。

调用示例请求与响应分开查看

<a id="curl-请求-5"></a>

### cURL 请求

```bash
curl 'https://y.junlistudio.com/v1/apps/chatgpt-refund/tasks?page=1&status=processing' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

<a id="响应-json-5"></a>

### 响应 JSON

```json
{
  "items": [
    {
      "id": "TASK_ID",
      "batch_id": "BATCH_ID",
      "key_id": "KEY_ID",
      "account": "al***@example.com",
      "fee": "7.12345678",
      "status": "processing",
      "progress": 65,
      "requires_otp": false,
      "failure_code": "",
      "settled": false,
      "created_at": "2026-10-12T08:00:00Z",
      "updated_at": "2026-10-12T08:01:00Z"
    }
  ],
  "total": 1,
  "page": 1
}
```

将占位值替换为你的数据 · 示例不发起真实请求

金额、时间与版本均为结构示例，以真实接口返回为准。