单元作文详情

一句话说明

按年级、册别、单元查询平台内置的同步作文题目,用于预填标题、题干、建议字数与总分。
同步查询,不扣费


你会得到什么

data 为数组;同一单元可能有多道可选题目。无数据时返回空数组。

字段 说明
id 配置 ID
grade / season / unit 年级、册别、单元
type 文体;空可按「不限」
zongfen 建议总分
zishu 建议字数
title 题目
content 题干 / 写作要求

怎么调用

  • 方法:GET
  • 地址:https://api.21days.cloud/opi/p/c012/zuowen/unit
  • Header:accessToken
参数 类型 必填 说明
grade Number 年级,如 3=三年级
season Number 1=上册,2=下册
unit Number 单元号,如 12

成功示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"code": 1,
"data": [
{
"id": 123,
"grade": 3,
"season": 1,
"unit": 2,
"type": "写人为主的记叙文",
"zongfen": 100,
"zishu": 300,
"title": "猜猜他是谁",
"content": "选择一位同学,通过外貌、性格或爱好等方面写出人物特点。"
}
]
}

无匹配数据时:

1
{ "code": 1, "data": [] }

对接检查清单

  1. grade / season / unit 是否按数字传
  2. 是否兼容返回多条题目供用户选择
  3. 空数组是否按「暂无题目」展示,而不是当失败

关联文档

主题 文档
创建批改 创建作文批改
接口索引 接口总览索引