DIYP软件的核心接口是什么

在实际部署 DIYP 影音管理系统时，最让人纠结的往往不是前端的 UI，而是它背后那层看不见的“核心接口”。这套接口像是系统的血脉，负责把用户、直播源以及计费信息在数据库与客户端之间来回穿梭。若把整个项目比作一台机器，核心接口就是那根连接发动机与控制面板的钢铁管道。

核心接口的结构层次

DIYP 的接口整体分为三层：路由层（Router）、业务层（Service）以及数据访问层（DAO）。路由层仅负责解析 HTTP 请求的路径与方法，随后把请求转交给对应的业务层函数；业务层封装业务规则，例如用户注册时需要校验邀请码、直播源添加时要检查码率是否合法；DAO 则是对 Django ORM 的一次封装，负责把业务层的对象持久化到 PostgreSQL 或 MySQL。

常用 API 列表

• GET /api/v1/users/ 获取用户列表，支持分页和模糊搜索。
• POST /api/v1/users/ 创建新用户，必须携带 username、password、email 三个字段。
• GET /api/v1/sources/ 列出所有直播源，返回字段包括 id、url、bitrate、status。
• POST /api/v1/sources/ 新增直播源，后端会自动检测 URL 的可达性并写入 source_status 表。
• PUT /api/v1/sources/{id}/ 更新指定直播源的属性，常用于切换码率或更换分发节点。

接口实现细节：认证与错误处理

DIYP 采用 JWT（JSON Web Token）进行无状态认证。登录成功后服务器返回的 access_token 必须在后续请求的 Authorization: Bearer <token> 头部中携带。值得注意的是，token 的有效期默认是 2 小时，超过后会返回 401 状态码，前端需要捕获并主动触发刷新接口 POST /api/v1/auth/refresh/。

# 示例：使用 Python requests 调用用户列表
import requests, json

url = "http://your-server.com/api/v1/users/?page=1&search=admin"
headers = {"Authorization": "Bearer YOUR_JWT_TOKEN"}
resp = requests.get(url, headers=headers)

if resp.status_code == 200:
    data = resp.json()
    print(json.dumps(data, indent=2, ensure_ascii=False))
else:
    print(f"请求失败，状态码: {resp.status_code}")

错误码的设计同样遵循 RESTful 的最佳实践：400 表示参数校验不通过，403 用于权限不足，404 则是资源未找到。每一次异常响应都会在 body 中返回一个统一结构的 JSON，字段包括 code、message 与可选的 detail，这让前端的错误提示可以直接映射。