查询作文详情

一句话说明

用创建时拿到的作文 ID，主动查询批改结果。
data 结构与 发送作文批改结果 回调中的 data 一致，适合补拉、对账与排查。

你会得到什么

与成功回调相同的一套结果字段，例如：

字段 说明
version_name 如 cn_v1、en_v4
status 任务状态（如 1 完成）
pigai / pangpi / runse 等 批改结果主体
error_code 失败场景下可能出现
transmission 创建时透传字段

实时展示以回调为准；本接口用于事后补拉与排查。

怎么调用

  • 方法：GET
  • 地址：https://api.21days.cloud/opi/p/c012/detail
  • Header：accessToken
  • 查询参数：
参数 类型 必填 说明
zuowen_id String 是 创建接口返回的作文 ID

使用注意

  1. 结果有保存期限（约 1 周），超时后可能查不到
  2. 查询结果可能存在短暂延迟，不要把它当成唯一实时通道
  3. 失败时的 error_code 以回调为准更可靠；查询不一定每次都带回
  4. 未作答场景：顶层仍可能 code=1，但 pigai.score=0 且 pigai.no_answer=true

成功响应示意

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "code": 1,
  "msg": "",
  "data": {
    "zuowen_id": "u3EDmPW",
    "version_name": "cn_v1",
    "status": 1,
    "pigai": {
      "score": 82,
      "comment": "……"
    }
  }
}

data 完整字段说明见 发送作文批改结果，各版本差异见对应版本文档。

对接检查清单

  1. 是否用创建返回的 data.id 作为 zuowen_id
  2. 回调未收到时，是否用本接口补拉，而不是重复盲目创建
  3. 是否兼容「批改尚未完成」时的中间状态
  4. 是否在约 1 周内完成必要对账

关联文档

主题 文档
创建接口 创建作文批改
回调结构 发送作文批改结果
接口索引 接口总览索引