POST/api/public/v1/grade-sessions/{id}/submissions

grade_submissions.create

所需权限: grades:submit
类别: 写入
计费: 按改卷页数计
幂等: 必须带 Idempotency-Key 请求头；同一个键重试时返回第一次的结果
MCP 工具: submit_grade_sheets

参数

id位置 path必填是类型 string (uuid)
Idempotency-Key位置 header必填是类型 string (uuid)

请求体

{
  "type": "object",
  "properties": {
    "previewId": {
      "type": "string",
      "format": "uuid"
    },
    "expectedRevision": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    }
  },
  "required": [
    "previewId",
    "expectedRevision"
  ],
  "additionalProperties": false
}

成功响应 202

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "partially_succeeded",
        "needs_action",
        "cancelling",
        "cancelled"
      ]
    },
    "requestId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "jobId",
    "status",
    "requestId"
  ],
  "additionalProperties": false
}

可能返回的错误状态码

400401403404409429500503

所有错误都用同一种错误信封返回，原因码见错误与限流。