查询小练笔详情

通过创建接口返回的 ID 查询小练笔批改结果，用于事后对账、补拉数据或排查问题。

  • 注意：数据只保存 1 周，且 30 秒更新一次，可能非实时数据，以回调通知数据为准。

HTTP 方法：get

请求地址

1
https://api.21days.cloud/opi/p/c012/micro_writing/detail

请求参数

字段名 类型 描述
micro_writing_id string 创建小练笔批改时返回的 data.id

返回响应

字段 类型 必选 示例 解释
code Number 是 1 1=正常，0=异常，-1=未登录
msg String 否 - 提示信息
data object 否 见示例 与回调接口 data 基本一致，额外包含 micro_writing_id

data 字段说明

data 字段结构与回调接口《发送作文批改结果》中 data 完全一致，常用字段包括：

字段名 类型 描述
micro_writing_id string 当前小练笔任务 ID（创建接口返回的 id）
status int 状态：0=待提交，2=进行中，1=已完成，-1=失败
title string 题目
content string 学生小练笔正文（文本模式直接保存；图片模式为 OCR 识别后的文本）
ocr_text object OCR 识别结果（仅图片模式存在），结构与大作文一致
pigai object 批改结果，字段定义见下文，与大作文同款字段对齐
pangpi object 片段点评，结构与大作文一致：{ commit_items, commit_total }
runse object 示范改写，结构与大作文一致：{ title, content, explain }
transmission object 创建时传入的透传字段（如有）
version_name string 版本名称，例如 cn_v1。回调中稳定返回；详情接口为可选字段，如未返回，可按创建时的 subject + version 判断
note object 失败原因等内部状态信息

pigai 字段说明（小练笔语义，字段名与大作文对齐）

字段名 类型 描述
score int 总分
total_score int 总分（与 score 一致，便于和英语 v3/v4 字段对齐）
score_items array 各维度实际得分（与创建时入参 score_items 结构不同）。元素 { item, score, reason }：item 为维度名，score 为该项得分，reason 为评分解析。维度名称与数量应与创建任务时一致，详见《小练笔批改》「score_items 说明」
requirements string 本次小练笔的写作要求/训练目标
comment string 总体评语
modify string 主要错误及修改建议
highlights string 亮点（多个小点用换行分隔）
highlight_items array 结构化亮点，元素 { origin_sentence, reason }
suggestions string 不足和建议（多个小点用换行分隔）

pangpi、runse 字段细节

均沿用大作文同款结构，详细字段说明见《发送作文批改结果》中 pangpi 对象细节、runse 对象细节 章节。

  • pangpi.commit_items[].good_or_bad 取值：good / bad
  • runse.content 为示范改写（小练笔片段长度），runse.explain 为润色说明，建议用数字序号 + 换行分隔。

示例返回（节选）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
  "code": 1,
  "data": {
    "micro_writing_id": "SyXczVD",
    "status": 1,
    "title": "我的心儿怦怦跳",
    "content": "今天上台演讲的时候，我的心怦怦直跳……",
    "pigai": {
      "score": 82,
      "total_score": 82,
      "score_items": [
        { "item": "切题", "score": 18, "reason": "能围绕题干情境展开。" },
        { "item": "目标达成", "score": 25, "reason": "能写出心理变化，事情经过还可以更具体。" },
        { "item": "内容具体", "score": 16, "reason": "有心理描写，动作和环境细节还可补充。" },
        { "item": "语言表达", "score": 17, "reason": "语句通顺，符合四年级表达水平。" },
        { "item": "结构清楚", "score": 6, "reason": "片段层次基本清楚，过渡略简单。" }
      ],
      "requirements": "把事情经过写清楚，并写出心理变化",
      "comment": "这段小练笔能围绕题目展开，心理描写比较明显，但动作和环境描写还不够丰富。",
      "modify": "1. 原文：我很紧张；问题：只说了感受，缺少具体表现；修改建议：补充手心出汗、声音发抖等细节。",
      "highlights": "1. 心理描写直接，能直接表现紧张感。",
      "highlight_items": [
        { "origin_sentence": "我的心怦怦直跳", "reason": "能直接表现紧张心理。" }
      ],
      "suggestions": "1. 补充上台前和开口时的动作描写。"
    },
    "pangpi": {
      "commit_items": [
        {
          "origin_sentence": "我的心怦怦直跳",
          "good_or_bad": "good",
          "commit": "能直接表现紧张心理。"
        }
      ],
      "commit_total": "片段点评总评：能围绕训练目标展开，可补充更具体的动作细节。"
    },
    "runse": {
      "title": "我的心儿怦怦跳",
      "content": "轮到我上台时，我攥紧了稿纸，手心里全是汗，连第一句话都差点忘了。",
      "explain": "1. 补充上台前的动作细节；2. 用“手心全是汗”代替直白的“紧张”，增强画面感。"
    },
    "transmission": {
      "student_id": "s001",
      "homework_id": "h001"
    }
  }
}

建议：

  • 实时展示以回调结果为准，查询接口更适合用于事后对账、重试展示或排查问题。
  • 若回调未收到但查询已有结果，可根据 micro_writing_id 直接补拉数据。