# XXXS

**Repository Path**: osle/XXXS

## Basic Information

- **Project Name**: XXXS
- **Description**: 学习兴税辅助学习程序
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2022-05-14
- **Last Updated**: 2022-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 学习兴税协议分析

　　今年又开始学习兴税了，花了一点时间对兴税的协议进行了简单的分析。有兴趣的朋友们可以动手自己写个辅助程序。总体来说学习兴税的学习逻辑是比较简单的，先是获取课目，然后根据对应课目获取课程。然后通过GET指定课程UUID告诉服务器开始学习对应课程，当对应课程学习完时，再通过GET方式告诉服务器学习结束。<br>
　　我就这个逻辑写了一个小辅助程序，一来练手当学习语言，二来起到抛砖引玉的目的，期待大神的指正。

### 一、登陆
　　由于登陆涉及加解密，有兴趣的朋友可以自行研究，我就不赘述了。
### 二、获取课目列表
    我只对部分关键字段进行说明，有兴趣的朋友可以自行研究。
|类别|参数|
|---|---|
|URL|https://xingshui.chinatax.gov.cn/NewSoke/course/home/v1/course?lang=zh&utcoffset=-28800&action=learning_center&page=1&limit=10|
|method|GET|
|QueryString|lang、utcoffset、action、page、limit|
|Response Data|JSON Data|

一个课目对应有多个课程，通过观察和分析我们可以得出程目前课目里包含视频、文档、练习题几种类型。

|返回数据|类型|说明|
|---|---|---|
|credit|数字|本课目的积分，也就是通过学习能获取到的积分|
|title|字符|该课目的标题|
|UUID|字符|该课目的UUID号，用于区别其它课目|

### 三、获取课目对应的课程
|类别|参数|
|---|---|
|URL|https://xingshui.chinatax.gov.cn/NewSoke/course/home/v1/courseLesson?lang=zh&utcoffset=-28800&course_id=603E8F7A-A750-487A-A492-31A4D60F2517|
|method|GET|
|QueryString|lang、utcoffset、course_id|
|参数|说明|
|course_id|要获取的课目UUID号|
|Response Data|JSON Data|

反回数据

|返回数据|类型|说明|
|---|---|---|
|length|数字|该课程时长|
|title|字符|该课程名称|
|type|字符|课程类型|
|uuid|字符|课程对应的UUID|

### 四、将课目加入我的课程学习
|类别|参数|
|---|---|
|URL|https://xingshui.chinatax.gov.cn/NewSoke/course/home/v1/courseUser?lang=zh&utcoffset=-28800|
|method|POST|
|QueryString|lang、utcoffset|
|参数|说明|
|course_id|需要学习课目的UUID号|
|from|固定字符串可以不管，默认是course|
|Response Data|JSON Data|

在反回的 JSON 数据中就能看到“message=加入学习成功”表示该课目已成功加入学习。

### 五、开始学习课程
|类别|参数|
|---|---|
|URL|https://xingshui.chinatax.gov.cn/NewSoke/course/home/v1/courseLessonLearn/startLearn?lang=zh&utcoffset=-28800&lesson_id=3788E429-4EA0-462F-B298-212B841FC01C|
|method|GET|
|QueryString|lang、utcoffset、lesson_id|
|参数|说明|
|lesson_id|学习课程的UUID号|
|Response Data|JSON Data|

### 六、结束学习课程
|类别|参数|
|---|---|
|URL|https://xingshui.chinatax.gov.cn/NewSoke/course/home/v1/courseLessonLearn/startLearn?lang=zh&utcoffset=-28800&lesson_id=3788E429-4EA0-462F-B298-212B841FC01C|
|method|GET|
|QueryString|lang、utcoffset、lesson_id、course_id|
|参数|说明|
|lesson_id|学习课程的UUID号|
|course_id|学习课目的UUID号|
|Response Data|JSON Data|