# API接口文档

**项目代号**: A00  
**项目名称**: TJFS集团官方网站及Web服务器  
**文档类型**: API接口文档  
**创建日期**: 2026-03-05  
**编制人**: TBs  
**文档版本**: V1.0  
**文档状态**: 已批准

---

## 目录

1. [接口概述](#一接口概述)
2. [公共说明](#二公共说明)
3. [静态文件接口](#三静态文件接口)
4. [错误码说明](#四错误码说明)
5. [附录](#五附录)

---

## 一、接口概述

### 1.1 基本信息

| 项目 | 内容 |
|------|------|
| 接口基础路径 | / |
| 接口协议 | HTTP |
| 数据格式 | HTML/CSS/JS/JSON |
| 字符编码 | UTF-8 |
| 服务器端口 | 80（默认）/ 8537（备用）|

### 1.2 接口列表

| 接口编号 | 接口名称 | 请求方法 | 接口路径 | 说明 |
|----------|----------|----------|----------|------|
| API-001 | 首页 | GET | / | TJFS集团官网首页 |
| API-002 | SG Studio | GET | /sgstudio/ | 松果工作室子站点 |
| API-003 | TBs科技 | GET | /tbs/ | 创生软件子站点 |
| API-004 | CSS样式 | GET | /css/style.css | 主样式文件 |
| API-005 | JavaScript | GET | /js/main.js | 主脚本文件 |

---

## 二、公共说明

### 2.1 请求头

| 请求头 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| Accept | string | 否 | text/html, application/json |
| Accept-Encoding | string | 否 | gzip, deflate |
| Accept-Language | string | 否 | zh-CN, zh, en |
| User-Agent | string | 否 | 浏览器标识 |

### 2.2 响应头

| 响应头 | 说明 |
|--------|------|
| Content-Type | 根据文件类型自动设置 |
| Content-Length | 文件大小 |
| Access-Control-Allow-Origin | *（允许跨域）|
| Access-Control-Allow-Methods | GET, POST, OPTIONS |
| Access-Control-Allow-Headers | Content-Type |

### 2.3 响应格式

#### HTML响应

```http
HTTP/1.0 200 OK
Content-Type: text/html; charset=utf-8
Content-Length: 12345
Access-Control-Allow-Origin: *

<!DOCTYPE html>
<html lang="zh-CN">
...
</html>
```

#### CSS响应

```http
HTTP/1.0 200 OK
Content-Type: text/css
Content-Length: 5678
Access-Control-Allow-Origin: *

/* CSS内容 */
```

#### JavaScript响应

```http
HTTP/1.0 200 OK
Content-Type: application/javascript
Content-Length: 9012
Access-Control-Allow-Origin: *

// JavaScript内容
```

---

## 三、静态文件接口

### 3.1 首页

**基本信息**

| 项目 | 内容 |
|------|------|
| 接口路径 | / |
| 请求方法 | GET |
| 认证要求 | 否 |
| 接口描述 | TJFS集团官网首页 |

**请求参数**

无

**响应参数**

| 参数名 | 类型 | 说明 |
|--------|------|------|
| - | HTML | 首页HTML内容 |

**响应示例**

```html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>T.J.F.S.集团 | 天工未来</title>
    ...
</head>
<body>
    ...
</body>
</html>
```

---

### 3.2 SG Studio子站点

**基本信息**

| 项目 | 内容 |
|------|------|
| 接口路径 | /sgstudio/ |
| 请求方法 | GET |
| 认证要求 | 否 |
| 接口描述 | 松果工作室子站点首页 |

**请求参数**

无

**响应参数**

| 参数名 | 类型 | 说明 |
|--------|------|------|
| - | HTML | SG Studio首页HTML内容 |

---

### 3.3 TBs科技子站点

**基本信息**

| 项目 | 内容 |
|------|------|
| 接口路径 | /tbs/ |
| 请求方法 | GET |
| 认证要求 | 否 |
| 接口描述 | 创生软件子站点首页 |

**请求参数**

无

**响应参数**

| 参数名 | 类型 | 说明 |
|--------|------|------|
| - | HTML | TBs科技首页HTML内容 |

---

### 3.4 CSS样式文件

**基本信息**

| 项目 | 内容 |
|------|------|
| 接口路径 | /css/style.css |
| 请求方法 | GET |
| 认证要求 | 否 |
| 接口描述 | 主样式文件 |

**请求参数**

无

**响应参数**

| 参数名 | 类型 | 说明 |
|--------|------|------|
| - | CSS | 样式规则 |

---

### 3.5 JavaScript文件

**基本信息**

| 项目 | 内容 |
|------|------|
| 接口路径 | /js/main.js |
| 请求方法 | GET |
| 认证要求 | 否 |
| 接口描述 | 主脚本文件 |

**请求参数**

无

**响应参数**

| 参数名 | 类型 | 说明 |
|--------|------|------|
| - | JavaScript | 脚本代码 |

---

## 四、错误码说明

### 4.1 HTTP状态码

| 状态码 | 说明 |
|--------|------|
| 200 | 成功 |
| 304 | 未修改（缓存）|
| 400 | 请求参数错误 |
| 404 | 资源不存在 |
| 500 | 服务器内部错误 |

### 4.2 错误响应示例

#### 404 Not Found

```http
HTTP/1.0 404 Not Found
Content-Type: text/html; charset=utf-8

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
        "http://www.w3.org/TR/html4/strict.dtd">
<html>
    <head>
        <title>Error response</title>
    </head>
    <body>
        <h1>Error response</h1>
        <p>Error code: 404</p>
        <p>Message: File not found.</p>
    </body>
</html>
```

#### 500 Internal Server Error

```http
HTTP/1.0 500 Internal Server Error
Content-Type: text/html; charset=utf-8

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
        "http://www.w3.org/TR/html4/strict.dtd">
<html>
    <head>
        <title>Error response</title>
    </head>
    <body>
        <h1>Error response</h1>
        <p>Error code: 500</p>
        <p>Message: Internal Server Error.</p>
    </body>
</html>
```

---

## 五、附录

### 附录A: 接口调用示例

#### cURL示例

```bash
# 访问首页
curl -X GET "http://localhost/"

# 访问CSS文件
curl -X GET "http://localhost/css/style.css"

# 访问JS文件
curl -X GET "http://localhost/js/main.js"
```

#### JavaScript示例

```javascript
// 获取首页内容
fetch('http://localhost/')
  .then(response => response.text())
  .then(html => console.log(html));

// 获取CSS文件
fetch('http://localhost/css/style.css')
  .then(response => response.text())
  .then(css => console.log(css));
```

#### Python示例

```python
import requests

# 访问首页
response = requests.get('http://localhost/')
print(response.status_code)
print(response.text)

# 访问CSS文件
response = requests.get('http://localhost/css/style.css')
print(response.status_code)
print(response.text)
```

### 附录B: 文件目录结构

```
web.sever/
├── index.html          # 首页
├── css/
│   └── style.css       # 主样式
├── js/
│   └── main.js         # 主脚本
├── sgstudio/
│   └── index.html      # SG Studio子站点
├── tbs/
│   └── index.html      # TBs科技子站点
└── start-server.py     # 服务器启动脚本
```

### 附录C: 变更记录

| 版本 | 日期 | 变更内容 | 变更人 |
|------|------|----------|--------|
| V1.0 | 2026-03-05 | 初始版本 | TBs |

---

**文档编制日期**: 2026-03-05  
**编制单位**: SG Studio - 松果工作室  
**文档版本**: V1.0