题库校对

简介

HI,您好,欢迎使用学而思网校AI开放平台题库校对接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师,详细描述题库校对能力相关的技术内容。您可以通过快速接入安全接入使用此AI能力。

接口能力

接口名称 接口能力简要描述 api 地址
题库校对 对题库内容进行错误校对 http://openapiai.xueersi.com/v1/api/nlp/nlp/correct_item

适用范围

任意操作系统,任意编程语言,均可以通过http或https调用本接口。

请求方式

HTTP 方法POST

请求 URLhttp://openapiai.xueersi.com/v1/api/nlp/nlp/correct_item

注意: Content-Type为application/json

Header 如下

参数名 赋值
Content-Type application/json

 

快速接入方式

请求参数详情

参数名 类型 是否必选 赋值说明 样例 备注
app_key string 应用标识 8102b22a5e81e840176d9f381ec6f837  
body object      

data

list

json, 包括: id, item, analytic, answer, materialContent, option, subject

 

试题列表

id

string

 

 

试题id(必须有)

item

string

 

 

题干(utf-8编码)

analytic

string

 

 

分析(utf-8编码)

answer

list

stirng类型

 

答案(utf-8编码)

materialContent

string

 

 

材料(utf-8编码)

option

list

stirng类型

 

选项(utf-8编码)

subject

int

1:语文

 

科目类型

请求代码示例

HTTP 代码示例:

POST /v1/api/nlp/nlp/correct_item?app_key=8102b22a5e81e840176d9f381ec6f837 HTTP/1.1
Host: openapiai.xueersi.com
Content-Type: application/json
User-Agent: PostmanRuntime/7.15.0
Accept: */*
Cache-Control: no-cache
Postman-Token: 56a71f64-e439-4b44-a51f-53c13cc4ae6b,2e551983-76b9-4679-9fbc-51c3e6577871
Host: openapiai.xueersi.com
accept-encoding: gzip, deflate
content-length: 460
Connection: keep-alive
cache-control: no-cache

{
    "data": [
        {
            "id": "100651",
            "item": "下列不属于墨子思想的是( )",
            "materialContent": "NULL",
            "analytic": "“克已复礼”是孔子思想。",
            "answer": [
                "D"
            ],
            "option": [
                "A",
                "B",
                "C",
                "D: 克己复礼"
            ],
            "subject": 1
        }
    ]
}

cURL 代码示例:

curl -X POST \
  'http://openapiai.xueersi.com/v1/api/nlp/nlp/correct_item?app_key=8102b22a5e81e840176d9f381ec6f837' \
  -H 'Accept: */*' \
  -H 'Cache-Control: no-cache' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json' \
  -H 'Host: openapiai.xueersi.com' \
  -H 'Postman-Token: 56a71f64-e439-4b44-a51f-53c13cc4ae6b,bbe24696-8914-471b-9ea7-e03ecdb1c393' \
  -H 'User-Agent: PostmanRuntime/7.15.0' \
  -H 'accept-encoding: gzip, deflate' \
  -H 'cache-control: no-cache' \
  -H 'content-length: 460' \
  -d '{
    "data": [
        {
            "id": "100651",
            "item": "下列不属于墨子思想的是( )",
            "materialContent": "NULL",
            "analytic": "“克已复礼”是孔子思想。",
            "answer": [
                "D"
            ],
            "option": [
                "A",
                "B",
                "C",
                "D: 克己复礼"
            ],
            "subject": 1
        }
    ]
}'

安全接入方式

请求参数详情

参数名 类型 是否必选 赋值说明 样例 备注
app_key string 应用标识 8102b22a5e81e840176d9f381ec6f837  
time_stamp string 秒级时间戳 1493468759 安全接入必备,用于唯一地标识某一刻的时间
nonce_str string 随机字符串 dd599ef889859f9fe 安全接入必备
sign string 签名信息 99880aabb33f4def5c875875b6bdc3b1 安全接入必备
body object      

data

list

json, 包括: id, item, analytic, answer, materialContent, option, subject

 

试题列表

id

string

 

 

试题id(必须有)

item

string

 

 

题干(utf-8编码)

analytic

string

 

 

分析(utf-8编码)

answer

list

stirng类型

 

答案(utf-8编码)

materialContent

string

 

 

材料(utf-8编码)

option

list

stirng类型

 

选项(utf-8编码)

subject

int

1:语文

 

科目类型

 

返回响应

返回格式

JSON格式

响应参数说明

参数名 类型 赋值说明 样例 备注
code int 返回码 0  
msg string 返回码解释 "请求成功"  
data obj 识别结果结构    

data

list

son, 包括: id, item, analytic, answer, materialContent, option, subject

 

校对后的试题列表

item

string

错误标签:<span class="proofreader"></span>

 

题干

analytic

string

错误标签:<span class="proofreader"></span>

 

分析

answer

string

错误标签:<span class="proofreader"></span>

 

答案

materialContent

string

错误标签:<span class="proofreader"></span>

 

材料

option

list

错误标签:<span class="proofreader"></span>

 

选项

status

int

0:失败

1:成功

 

通信状态字段

errorId

string

第一个出问题的数据id,出错后停止处理,立刻返回

 

包括编码错误,处理错误

errorCode

string

json格式错误: "101"

编码错误: "102"

处理错误: "103"

没有错误:""

 

错误类型


响应Body:
响应代码示例

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "result": {
      "data": [
        {
          "id": "100651",
          "item": "下列不属于墨子思想的是( )",
          "analytic": "“<span class=\"proofreader\">克已</span>复礼”是孔子思想。",
          "answer": [
            "D"
          ],
          "materialContent": "NULL",
          "option": [
            "A",
            "B",
            "C",
            "D: 克己复礼"
          ]
        }
      ],
      "errorId": "",
      "errorCode": "",
      "state": 1
    }
  }
}

常见问题及反馈

Back to top