---
title: FastAPI 后端 API 端点
type: fact
permalink: main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/fast-api-后端-api-端点
stable_id: 86452d01-8146-41aa-80f9-7d5481135394
scope: project
project_id: 6f47523e-e22e-4cdd-bd18-76e5e474ee0c
memory_type: fact
status: active
revision: 1
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
created_at: '2026-09-23T14:58:38.419566+00:00'
updated_at: '2026-09-23T14:58:38.419619+00:00'
tags:
- api
- endpoints
---

## 只读端点

- GET /api/profiles — 列出可用设备配置
- GET /api/status — 构建状态（running、exit_code、started_at、ended_at）
- GET /api/artifacts/{profile} — 列出构建产物
- GET /api/runtime-mirror/{profile}/{mirror_id} — 检查运行时镜像兼容性
- GET /api/package-catalog/{profile} — 软件目录
- GET /api/saved-config/{profile} — 读取已保存配置
- GET /api/logs/stream — SSE 实时日志流

## 写入端点

- PUT /api/saved-config/{profile} — 保存配置
- DELETE /api/saved-config/{profile} — 删除已保存配置
- POST /api/build — 启动构建
- POST /api/stop — 停止构建
- POST /api/package-catalog/{profile}/refresh — 同步软件目录

## 安全注意

- 所有端点无身份认证，监听 0.0.0.0
- 构建状态保存在单进程内存，重启或多 worker 会丢失