# 第三方无平台对接

**Repository Path**: supper-mind_0/3rd-party-api

## Basic Information

- **Project Name**: 第三方无平台对接
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-16
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 全局参数及要求

##### 1.1 请求域名为 https://api.chaosw.com

##### 1.2 每次请求，app_id（分配的app_id值）、ts（当前秒级时间戳）及sign（签名）是必传参数，接口文档中不再单独将这三个参数列出

##### 1.3 响应的数据结构体为json对象

```json
 {
  "code": "响应码，200-成功，500-失败",
  "data": "响应的数据，可能为json数组、对象、字符或空值，见具体接口示例",
  "info": "响应提示信息"
}
```
##### 1.4 请求有时效限制，每个请求链接生成后超过5分钟将提示请求失效

# 签名生成

##### 2.1. 将app_secret字符反转

##### 2.2. 取ts参数，将反转后的app_secret拼接，形成ts + 反转后的app_secret + ts 待签名字符，例如1729039137abc1729039137

##### 2.3. 将2.2中得到的字符串用md5（32位）加密

##### 2.4. 将2.3中得到的字符串转小写

        
# 接口

## 获取班级

##### URL： */caller/classes*

**请求方式：** POST

**请求参数：**

**返回值：**

```json
{
  "code": 200,
  "data": [
    {
      "id": "班级id，int",
      "name": "班级名，string",
      "exam_name": "考试项目名，string",
      "subject_name": "科目名，string"
    }
  ],
  "info": "请求成功"
}
```

## 获取直播课时

##### URL： */caller/lessons*

**请求方式：** POST

**请求参数：**

```json
{
  "class_id": "班级id，int"
}
```

**返回值：**

```json
{
  "code": 200,
  "data": [
    {
      "id": "课时id，int",
      "name": "课时名，string",
      "teacher_name": "主讲老师名，string",
      "start_time": "直播开始时间，string，年月日时分格式，如2024-10-15 19:00",
      "end_time": "直播结束时间，string，年月日时分格式，如2024-10-15 20:30"
    }
  ],
  "info": "请求成功"
}
```

## 获取直播链接

##### URL： */caller/live*

**请求方式：** POST

**请求参数：**

```json
{
  "lesson_id": "课时id，int"
}
```

**返回值：**

```json
{
  "code": 200,
  "info": "请求成功",
  "data": "直播H5页面链接，string"
}
```

## 获取近期直播

##### URL： */caller/recent*

**请求方式：** POST

**请求参数：**

```json
{
  "end": "截止日期，YYYY-MM-DD格式，可不传，不传默认为3个月后的日期"
}
```
> 最多查询未来3个月的直播

**返回值：**

```json
{
  "code": 200,
  "data": [
    {
      "id": "课时id，int",
      "name": "课时名，string",
      "teacher_name": "主讲老师，string",
      "class_name": "班级名，string",
      "start_time": "直播开始时间，string，年月日时分格式，如2024-10-15 19:00",
      "end_time": "直播结束时间，string，年月日时分格式，如2024-10-15 20:30"
    }
  ],
  "info": "请求成功"
}
```
## 获取拉流地址

##### URL： */caller/live_pull*

**请求方式：** POST

**请求参数：**

```json
{
  "lesson_id": "课时id"
}
```

**返回值：**

```json
{
  "code": 200,
  "data": "该课时直播拉流地址，string，例如https://pull-live.xxx.com/xx.flv",
  "info": "请求成功"
}
```
## 发送直播聊天信息

##### URL： */caller/live_chat*

**请求方式：** POST

**请求参数：**

```json
{
  "lesson_id": "课时id，int值",
  "user_id": "用户id，int值",
  "username": "用户名，string，最多10位",
  "msg": "聊天信息，string，最多100位"
}
```

**返回值：**

```json
{
  "code": 200,
  "info": "请求成功"
}
```
> 有调取频率限制，同一课时所有调用方合计限制在600次/分钟