口语素材/BearerWrite
Create speaking material
Create one speaking material. Exact question links are optional and are only written when explicitly provided; omitted links remain empty.
Endpoint
POST
/api/v1/agent/capabilities/ielts_speaking_materials_create请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| coreStory | string | 是 | coreStory |
| questionLinks | record[] | 否 | questionLinks |
| questionLinks.answerAngle | string | 否 | answerAngle |
| questionLinks.outline | unknown[] | 否 | outline |
| questionLinks.questionSlotId | number | 是 | questionSlotId |
| questionLinks.requiredAdaptation | string | 否 | requiredAdaptation |
| title | string | 是 | title |
调用示例
curl -X POST \
'https://work.ieltsbuddy.igopx.cn/api/v1/agent/capabilities/ielts_speaking_materials_create' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $IELTS_BUDDY_TOKEN' \
--data '{"coreStory":"<coreStory>","title":"Example"}'请求结构
{
"type": "object",
"properties": {
"coreStory": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"questionLinks": {
"maxItems": 30,
"type": "array",
"items": {
"type": "object",
"properties": {
"answerAngle": {
"default": "",
"type": "string",
"maxLength": 500
},
"outline": {
"default": [],
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 300
}
},
"questionSlotId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"requiredAdaptation": {
"default": "",
"type": "string",
"maxLength": 500
}
},
"required": [
"answerAngle",
"outline",
"questionSlotId",
"requiredAdaptation"
],
"additionalProperties": false
}
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"coreStory",
"title"
],
"additionalProperties": false
}统一响应
接口结果位于 data;code 为 0 表示调用成功。
{
"code": 0,
"data": {},
"message": "ok"
}错误码
400
40001请求参数不符合接口契约401
40101缺少或使用了无效的访问令牌403
40301访问令牌不包含接口所需权限404
40401接口或目标资源不存在