按年级上下册单元获取单元作文详情

用于按 grade + season + unit 查询平台内置的单元同步作文题目要求，适合合作方在“同步作文 / 单元作文”场景下预填作文标题、题干、建议字数和总分。

  • HTTP 方法：GET
  • 请求地址
    1
    https://api.21days.cloud/opi/p/c012/zuowen/unit
  • URL参数：
字段名 类型 是否必填 描述
grade int 是 年级，如 3=三年级、4=四年级
season int 是 上下册，1=上册，2=下册
unit int 是 单元编号，如 1、2、3
  • Header：accessToken 鉴权

返回响应

字段 类型 必选 示例 解释
code Number 是 1 1=正常，0=异常，-1=未登录
msg String 否 - 提示信息
data array 是 [] 单元作文详情列表

data 数组项字段说明

字段名 类型 示例 描述
id int 123 单元作文配置 ID
grade int 3 年级
season int 1 上下册，1=上册，2=下册
unit int 2 单元编号
type string 记叙文 文体类别，为空时可按“不限”处理
zongfen int 100 建议总分
zishu int 400 建议字数
title string 猜猜他是谁 作文题目
content string 选择一位同学，写出他的特点。 题干或写作要求

响应示例

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": "选择一位同学，通过外貌、性格或爱好等方面写出人物特点。"
    }
  ]
}

使用说明

  • 该接口可能返回多条数据，表示同一单元下存在多篇可选作文题，调用方可让用户自行选择。
  • 若没有匹配到对应年级、册别、单元的数据，接口会返回 {"code":1,"data":[]}。