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

更新评分接口(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"
}