Skip to main content

​
概述

蓝图库是 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_itemstring产出物 item_id（逗号分隔）
input_materialstring输入原料名（逗号分隔）
base_regionstring基地区域
base_locationstring子基地
power_min / power_maxint功率范围
server_regionstring服务器区域（cn/global）
facilitystring设备 item_id（逗号分隔）
creator_idstring作者用户 ID
keywordstring标题/描述关键词
sortstring排序字段
page / page_sizeint分页

​
排序方式

  • -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 "[email protected]"
返回 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 异步审核标题/描述/评论
  • 图片审核：增量审核，回调通知
  • 审核未通过的蓝图不会出现在公开列表中