{ "openapi": "3.0.3", "info": { "title": "教育学习", "description": "【教育学习API】是一款专注于作业批改、试卷还原和算术题批改的教育工具。它能帮助孩子们了解自己的学习情况。同时，它还能够将试卷或练习册扫描后还原出标准答案，支持口算批改、英文拼写检测、中文文本智能纠错、英语口语测评和试卷还原。操作简单便捷，响应速度快，准确率高，满足家长们对孩子教育的各种需求。", "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2", "version": "1.0.0" }, "servers": [ { "url": "https://route.showapi.com" } ], "paths": { "/2741-7": { "x-pointCode": 7, "x-mode": "mapping", "x-read-timeout": 50, "x-connect-timeout": 50, "post": { "summary": "英语口语测评", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number", "description": "错误码:\n0 成功\n10 文件下载失败\n20 文件解析失败\n40 参数错误\n50 文件内容过大\n60 文件格式错误\n70 操作失败,请勿重复提交\n80 服务超时\n90 未知错误()" }, "score": { "type": "number", "description": "总分数" }, "speed_grade": { "type": "number", "description": "语速得分" }, "fluency_grade": { "type": "number", "description": "流利度得分" }, "integrity_grade": { "type": "number", "description": "完整度得分" }, "list": { "type": "array", "items": { "type": "object", "properties": { "word": { "type": "string", "description": "单词" }, "score": { "type": "number", "description": "单词得分" }, "stress": { "type": "number", "description": "单词参考重读类型 0:不重读 1: 重读" }, "tone": { "type": "number", "description": "单词参考声调类型 1: 升调 -1: 降调 0: 平调" }, "linking": { "type": "number", "description": "单词参考连读类型 0:不连读 非0:连读(包括辅元连读和省略辅音)" }, "actual_stress": { "type": "number", "description": "单词实际重读类型, 同stress" }, "actual_tone": { "type": "number", "description": "单词实际声调类型, 同tone" }, "actual_linking": { "type": "number", "description": "单词实际连读类型, 同link" } } } } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2741_7_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "context": { "type": "string", "description": "检测文本内容" }, "voice": { "type": "string", "description": "检测语音base64" }, "model": { "type": "string", "description": "1:小学\n2:中学\n3:大学" }, "type": { "type": "string", "description": "支持采样率16k，单通道，16bit\n音频格式,1:mp3 2:wav" } }, "required": [ "context", "voice" ] } } } } } }, "/2741-6": { "x-pointCode": 6, "x-mode": "mapping", "x-read-timeout": 50, "x-connect-timeout": 50, "post": { "summary": "中文文本智能纠错", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number", "description": "错误码:\n0 成功\n10 文件下载失败\n20 图片解析失败\n40 参数错误\n50 文件内容过大\n60 文件格式错误\n70 操作失败,请勿重复提交\n80 服务超时\n90 未知错误()" }, "context": { "type": "string", "description": "原始内容" }, "result": { "type": "string", "description": "纠正后内容" }, "score": { "type": "number", "description": "得分" }, "fragment": { "type": "array", "items": { "type": "object", "properties": { "begin_index": { "type": "number", "description": "开始下标" }, "end_index": { "type": "number", "description": "结束下标" }, "original": { "type": "string", "description": "原始片段" }, "replace": { "type": "string", "description": "纠正后片段" } } } } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2741_6_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "context": { "type": "string", "description": "待检测内容" } }, "required": [ "context" ] } } } } } }, "/2741-5": { "x-pointCode": 5, "x-mode": "mapping", "x-read-timeout": 50, "x-connect-timeout": 50, "post": { "summary": "英文拼写检测", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number", "description": "错误码:\n0 成功\n10 文件下载失败\n20 图片解析失败\n40 参数错误\n50 文件内容过大\n60 文件格式错误\n70 操作失败,请勿重复提交\n80 服务超时\n90 未知错误()" }, "results": { "type": "array", "items": { "type": "string" }, "description": "检测结果" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2741_5_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "context": { "type": "string", "description": "待检测内容" } }, "required": [ "context" ] } } } } } }, "/2741-3": { "x-pointCode": 3, "x-mode": "mapping", "x-read-timeout": 50, "x-connect-timeout": 50, "post": { "summary": "试卷还原", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number" }, "result_img_url": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2741_3_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "img_url": { "type": "string", "description": "图片的URL地址（img_url与img_base64二选一）" }, "img_base64": { "type": "string", "minLength": 0, "maxLength": 10500000, "description": "图片的base64字符串（img_url与img_base64二选一）" } } } } } } } }, "/2741-2": { "x-pointCode": 2, "x-mode": "mapping", "x-read-timeout": 50, "x-connect-timeout": 50, "post": { "summary": "口算批改", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number", "description": "错误码" }, "results": { "type": "array", "items": { "type": "object", "properties": { "is_right": { "type": "number", "description": "批改结果是否正确: 1 正确 , 2 错误" }, "text": { "type": "string", "description": "识别文本" }, "text_range": { "type": "array", "items": { "type": "object", "properties": { "x": { "type": "number", "description": "该点距离图片左侧的像素" }, "y": { "type": "number", "description": "该点距离图片顶部的像素" } } }, "description": "识别内容所在区域,用四个点来表示" } } }, "description": "识别结果列表" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2741_2_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "img_url": { "type": "string", "description": "图片的URL地址（img_url与img_base64二选一）" }, "img_base64": { "type": "string", "minLength": 0, "maxLength": 2100000, "description": "图片的base64字符串（img_url与img_base64二选一）" } } } } } } } } }, "components": { "securitySchemes": { "AppKeyAuth": { "type": "apiKey", "in": "query", "name": "appKey", "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp" } }, "schemas": { "ShowapiResEnvelope": { "type": "object", "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）", "properties": { "showapi_res_code": { "type": "integer", "description": "API 返回的状态码" }, "showapi_res_error": { "type": "string", "description": "API 返回的错误信息" }, "showapi_res_id": { "type": "string", "description": "API 请求的唯一标识" }, "showapi_fee_num": { "type": "integer", "description": "API 调用计费次数" } } } } }, "security": [ { "AppKeyAuth": [] } ], "externalDocs": { "url": "https://www.showapi.com/apiGateway/view/2741?tab=book" }, "x-apiCode": "2741", "x-is-own": true, "x-is-op": true }