3 - 职业技能测评

3.1 - 单次测评-创建

  • 接口：/open-apis/stack/v1/evaluations
  • 方法：POST
  • 描述：创建测评
  • 请求参数
参数类型
是否必传
举例备注
user_idstring是第三方生成待测工程师账号的uuid发给我方
stack_uuidstring是2342ed2es技能栈uuid
self_ratinginteger是2自评等级 1:了解, 2:熟悉, 3:掌握, 4:精通, 5:专家 (默认1)
langstring是zh-cn语言 zh-cn,en,fr
  • 返回值
{
    "data": {
        "id": "579f7c35-dea2-4dc4-a5ad-3365cfa16268"
    },
    "msg": "success",
    "error_code": 0
}

3.2 - 单次测评-题目-获取

  • 接口：/open-apis/stack/v1/evaluations/questions/detail
  • 方法：GET
  • 描述：获取某个题目
  • 请求参数
参数类型
是否必传
举例备注
evaluation_idstring是579f7c35-dea2-4dc4-a5ad-3365cfa16268测评uuid
langstring是zh-cn语言 zh-cn,en,fr
  • 返回值
{
    "data": {
        "finished": false,
        "detail_id": "82c09303-7504-4d7c-acba-e8d36552075c",
        "time_max": 45, // 最大答题时间：专门的推题引擎中会计算题目是是否到期，到期了还没有答题就会自动判定为「未作答」
        "question": {
            "stem": "<p>下列哪个选项在reducer中正确使用了Object.assign来修改 state</p>",
            "languages": [
                "zh-cn",
                "en",
                "fr"
            ],
            "options": [
                {
                    "id": 2515,
                    "option": "<pre><code class=\"lang-js\">Object.assign(state, {visible: action.visible})</code></pre>"
                },
                {
                    "id": 2516,
                    "option": "<pre><code class=\"lang-js\">Object.assign(state, {},&nbsp; {visible: action.visible})</code></pre>"
                },
                {
                    "id": 2517,
                    "option": "<pre><code class=\"lang-js\">Object.assign({}, state, {visible: action.visible}</code></pre>"
                },
                {
                    "id": 2518,
                    "option": "<pre><code class=\"lang-js\">Object.assign({}, …state ,{visible: action.visible})</code></pre>"
                }
            ]
        },
        "count": {
            "max": 17,
            // 总题数
            "finished": 1,
            // 已完成题数
            "unfinished": 16
            // 还需要完成题数
        }
    },
    "msg": "success",
    "error_code": 0
}

3.3 - 单次测评-题目-作答

  • 接口：/open-apis/stack/v1/evaluations/questions/answer
  • 方法：POST
  • 描述：答题
  • 请求参数
参数类型
是否必传
举例备注
detail_idstring是82c09303-7504-4d7c-acba-e8d36552075c题目ID
start_atstring是2020-06-28 14:53:00开始答题时间
end_atstring是2020-06-28 14:55:00结束作答时间
time_usedinteger是35答题使用的秒数
has_answerinteger是0是否作答 0, 1
option_idinteger是232选项ID
langstring是zh-cn语言 zh-cn,en,fr
  • 返回值
{
    "data": null,
    "msg": "success",
    "error_code": 0
}

3.4 - 单次测评-题目-反馈

  • 接口：/open-apis/stack/v1/evaluations/questions/feedback
  • 方法：POST
  • 描述：如果题目有无法理解，错别字等问题，可以通过此接口进行反馈
  • 请求参数
参数类型
是否必传
举例备注
evaluation_idstring是579f7c35-dea2-4dc4-a5ad-3365cfa16268测评uuid
langstring是zh-cn语言 zh-cn,en,fr
detail_idstring是82c09303-7504-4d7c-acba-e8d36552075c题目ID
errors[]string是1'1' => '题目读不懂',
'2' => '正确答案被判定为错误',
'3' => '题目中有错别字',
'4' => '选项中没有正确答案',
  • 返回值
{
    "data": null,
    "msg": "success",
    "error_code": 0
}

3.5 - 单次测评-结果-详情

  • 接口：/open-apis/stack/v1/evaluations/info
  • 方法：GET
  • 描述：获取测评结果数据
  • 请求参数
参数类型
是否必传
举例备注
evaluation_idstring是579f7c35-dea2-4dc4-a5ad-3365cfa16268测评uuid
with_detailboolean否11: 返回详情
0：不返回详情；默认值：0
  • 返回值
{
    "data": {
        "id": "82c09303-7504-4d7c-acba-e8d36552075c",
        "total_question": 25,
        "end_at": "2020-12-11 14:35:32",
        "total_question_correct": 18,
        "total_time": 193.85,
        "self_rating": 5,
        "score": 359,
        "finished": true,
        "stack_level": 3,
        "medal": {
            "stack_uuid": "82c09303-7504-4d7c-acba-e8d36552075c",
            "name": "掌握",
            "min": 300,
            "max": 399,
            "image_url": "https://assets.jiker.com/_for_stack_sub_project/2020/0819/admin/VoqGj7SXBKhJvXMd96b2fDdu2yXrbBwSAaCHzlvf.png"
        },
        "details": [
            {
                "id": "0354bf41-3e4d-4db4-8980-76e59efe19a4",
                "has_answer": true,
                "is_correct": true,
                "answer": [
                    "12149"
                ],
                "confidence": 0.2553585955605497,
                "question": {
                    "stem": "nginx配置文件中定义首页索引文件名称的配置项是什么？",
                    "analysis": "index用来定义首页索引文件的名称",
                    "options": [
                        {
                            "id": 12149,
                            "option": "index",
                            "correct": true
                        },
                        {
                            "id": 12150,
                            "option": "root",
                            "correct": false
                        },
                        {
                            "id": 12151,
                            "option": "www",
                            "correct": false
                        },
                        {
                            "id": 12152,
                            "option": "server\\_name",
                            "correct": false
                        }
                    ]
                }
            }
        ]
    },
    "msg": "success",
    "error_code": 0
}

3.6 - 单次测评-学习推荐

  • 接口：/open-apis/stack/v1/evaluations/recommend
  • 方法：GET
  • 描述：弱项推荐，课程和相关知识点
  • 请求参数
参数类型
是否必传
举例备注
evaluation_idstring是579f7c35-dea2-4dc4-a5ad-3365cfa16268测评uuid
  • 返回值
{
    "data": {
        "strong_spots": {
            "courses": [
                {
                    "lesson_uuid": "32li2313",
                    "lesson_name": "课节3"
                }
            ],
            "knowledge_points": [
                {
                    "uuid": '23d3s341',
                    "name": "知识点5"
                }
            ]
        },
        "weak_spots": {
            "courses": [
                {
                    "lesson_uuid": "234sd23",
                    "lesson_name": "课节1"
                }
            ],
            "knowledge_points": [
                {
                    "uuid": '2342dsew',
                    "name": "知识点1"
                }
            ]
        }
    },
    "msg": "success",
    "error_code": 0
}
上次更新:
Contributors: 顾金鹤, PeikyLiu