文档首页/ 云客服/ API参考/ 调查问卷/ 更新评分接口（updateScore）
更新时间：2023-09-27 GMT+08:00
查看PDF
分享

更新评分接口（updateScore）

场景描述

与第三方培训考试系统对接时使用。

用于在我方调用UEBA结束考试接口后（接口路径通过随路数据传给UEBA），UEBA方读取后，计算得分，并回调更新我方问卷模块的操作类分数。

接口方法

POST

接口URI

https://域名/apiaccess/ngcrmpfcore_js/csf/exam/sorceresult，例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定值：application/json

2

Authorization

String（64）

True

鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）

3

x-app-key

String（64）

True

appKey字段，用户标识，请联系运营人员获取appKey

4

quotiety

Number

False

操作类分数权重。

调用结束考试接口时，通过随路数据传给UEBA

小于100的正整数

5

totalScore

Number

False

问卷模块的总分

调用结束考试接口时，通过随路数据传给UEBA
表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

params

object

True

-

1.1

exam_id

String（32）

True

考试唯一标识

1.2

param

object

True

-

1.2.1

code

String（16）

True

UEBA的结束考试接口处理结果码

0：成功

12000013：存在参数为空

12000016：参数错误，具体错误信息在rtnMsg中返回；

1201008：问题或问卷脚本不存在

1203999：系统错误，请联系开发人员

1.2.2

msg

String（256）

False

UEBA的结束考试接口处理结果描述信息

1.2.3

result

String（8）

True

计算得分，小数点前最多8位，保留两位小数

计算得分=操作类分数权重*题目分数/100*UEBA百分制得分/100

响应说明

  • 响应状态码: 200
    表3 响应体参数

    序号

    名称

    参数类型

    是否必选

    说明

    1

    rtnCode

    String

    True

    接口返回码

    0：接口调用成功

    其他：失败

    2

    rtnMsg

    String

    True

    接口返回消息描述。
  • 响应状态码: 400

    错误的请求：请检查请求路径及参数

  • 响应状态码: 401

    未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。

  • 响应状态码: 403

    鉴权失败

  • 响应状态码: 404

    请求的内容未找到：请检查请求的路径

  • 响应状态码: 500

    业务失败：请依次确认您请求中各参数的取值。

错误码

  • 无

报文样例

请求头:

{
"Content-Type": application/json
"x-app-key": ********************
"Authorization": Bearer ************************
"totalScore": 90
"quotiety": 80
}
请求参数: 
{
  "params": {
    "exam_id": "1247589060755793923"，
    "param": {
      "code": "0"，
      "result": "100.0"，
      "msg": "处理成功"
    }
  }
}
响应参数: 
{
    "rtnMsg": "query success!"，
    "rtnCode": "0"
}

父主题： 调查问卷