蓝图库集成

概述

蓝图库是 Endfield API 的社区功能模块，支持蓝图发布、搜索、点赞、评论和收藏。

公开接口

以下接口使用 UnifiedAuth（API Key / JWT / Anonymous Token 三选一）。

蓝图列表

curl "https://api.end.shallow.ink/api/blueprints?sort=-likes_count&page=1&page_size=20" \
  -H "X-API-Key: sk_your_api_key"

筛选参数

参数	类型	说明
`output_item`	string	产出物 item_id（逗号分隔）
`input_material`	string	输入原料名（逗号分隔）
`base_region`	string	基地区域
`base_location`	string	子基地
`power_min` / `power_max`	int	功率范围
`server_region`	string	服务器区域（cn/global）
`facility`	string	设备 item_id（逗号分隔）
`creator_id`	string	作者用户 ID
`keyword`	string	标题/描述关键词
`sort`	string	排序字段
`page` / `page_size`	int	分页

排序方式

-created_at（默认）：最新发布
likes_count：最多点赞
views_count：最多浏览
copies_count：最多复制

蓝图详情

curl https://api.end.shallow.ink/api/blueprints/{id} \
  -H "X-API-Key: sk_your_api_key"

评论列表

curl https://api.end.shallow.ink/api/blueprints/{id}/comments \
  -H "X-API-Key: sk_your_api_key"

需要登录的接口

以下接口需要 Web JWT 认证。

发布蓝图

curl -X POST https://api.end.shallow.ink/api/blueprints \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "高效钢铁产线",
    "description": "四号谷地钢铁自动化蓝图",
    "blueprint_code": "BP:xxxxx",
    "base_region": "四号谷地",
    "base_location": "四号谷地主基地",
    "server_region": "cn",
    "output_items": [{"item_id": "123", "name": "钢铁"}],
    "images": ["https://..."]
  }'

点赞/取消点赞

curl -X POST https://api.end.shallow.ink/api/blueprints/{id}/like \
  -H "Authorization: Bearer eyJhbGciOi..."

发表评论

评论需要 Cap PoW 验证码防刷：

# 1. 获取 PoW 挑战
curl -X POST https://api.end.shallow.ink/api/v1/cap/challenge

# 2. 前端解算 SHA-256 PoW

# 3. 兑换验证 Token
curl -X POST https://api.end.shallow.ink/api/v1/cap/redeem \
  -d '{"token": "...", "solutions": [...]}'

# 4. 发表评论
curl -X POST https://api.end.shallow.ink/api/blueprints/{id}/comments \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{"content": "好用！", "cap_token": "cap_xxx"}'

编辑/删除蓝图

仅创建者可操作：

# 编辑（PUT，字段可选，只传需更新的）
curl -X PUT https://api.end.shallow.ink/api/blueprints/{id} \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{"title": "新标题"}'

# 删除（自动清理关联点赞/评论/收藏/浏览记录）
curl -X DELETE https://api.end.shallow.ink/api/blueprints/{id} \
  -H "Authorization: Bearer eyJhbGciOi..."

记录蓝图码复制

curl -X POST https://api.end.shallow.ink/api/blueprints/{id}/copy \
  -H "Authorization: Bearer eyJhbGciOi..."

同一用户/IP 对同一蓝图每小时只计一次。

收藏夹管理

# 获取收藏夹列表（自动确保默认收藏夹存在）
curl https://api.end.shallow.ink/api/blueprints/my/collections \
  -H "Authorization: Bearer eyJhbGciOi..."

# 创建收藏夹（每人最多 50 个）
curl -X POST https://api.end.shallow.ink/api/blueprints/my/collections \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{"title": "高效产线", "is_public": true}'

# 收藏蓝图到收藏夹
curl -X POST https://api.end.shallow.ink/api/blueprints/{id}/favorite \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{"collection_id": "收藏夹ID"}'

# 取消收藏
curl -X DELETE "https://api.end.shallow.ink/api/blueprints/{id}/favorite?collection_id=xxx" \
  -H "Authorization: Bearer eyJhbGciOi..."

创作者主页 & 我的蓝图

# 查看某用户的蓝图
curl "https://api.end.shallow.ink/api/blueprints/creators/{user_id}?sort=-created_at" \
  -H "X-API-Key: sk_your_api_key"

# 我的蓝图（含草稿）
curl "https://api.end.shallow.ink/api/blueprints/my/list?status=published" \
  -H "Authorization: Bearer eyJhbGciOi..."

# 我点赞的蓝图
curl https://api.end.shallow.ink/api/blueprints/my/liked \
  -H "Authorization: Bearer eyJhbGciOi..."

蓝图元数据

获取基地选项、输入原料、排序字段等枚举数据：

curl https://api.end.shallow.ink/api/blueprints/meta \
  -H "X-API-Key: sk_your_api_key"

图片上传

蓝图图片通过对象存储上传（私有空间，最大 10MB，仅 jpg/png/webp）：

curl -X POST https://api.end.shallow.ink/api/blueprints/upload/image \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -F "file=@blueprint.png"

返回 key（对象存储 key）和 url（签名临时链接）。展示时后端自动将 key 签名为临时 URL。也可手动获取签名 URL：

curl "https://api.end.shallow.ink/api/blueprints/image/sign?key=blueprints/2026/02/xxx.jpg" \
  -H "X-API-Key: sk_your_api_key"

审核机制

文字审核：AI 异步审核标题/描述/评论
图片审核：增量审核，回调通知
审核未通过的蓝图不会出现在公开列表中

开始使用

核心概念

使用指南

概述

公开接口

蓝图列表

筛选参数

排序方式

蓝图详情

评论列表

需要登录的接口

发布蓝图

点赞/取消点赞

发表评论

编辑/删除蓝图

记录蓝图码复制

收藏夹管理

创作者主页 & 我的蓝图

蓝图元数据

图片上传

审核机制

​概述

​公开接口

​蓝图列表

​筛选参数

​排序方式

​蓝图详情

​评论列表

​需要登录的接口

​发布蓝图

​点赞/取消点赞

​发表评论

​编辑/删除蓝图

​记录蓝图码复制

​收藏夹管理

​创作者主页 & 我的蓝图

​蓝图元数据

​图片上传

​审核机制

概述

公开接口

蓝图列表

筛选参数

排序方式

蓝图详情

评论列表

需要登录的接口

发布蓝图

点赞/取消点赞

发表评论

编辑/删除蓝图

记录蓝图码复制

收藏夹管理

创作者主页 & 我的蓝图

蓝图元数据

图片上传

审核机制