api · reference

taste · api

给 agent / 程序员读的规范:图怎么存的、怎么用 API 拉、怎么申请 read key。

taste-index.md 格式示例

---
# 颜色
primary_color: "#8A6E4B"
secondary_color: "#3D2E22"
color_palette_type: "低饱和大地色系"
# 字体
font_style: "无衬线"
font_mood: "冷淡、克制、高级"
# 排版
layout: "居中对称"
density: "极简"
# 视觉
mood: "冷淡 / 高级 / 极简 / 知性"
style_tags: ["极简主义", "日式侘寂", "Quiet Luxury"]
---

## 元素:针织上衣(画面中段)

### 普通知识
- Loro Piana 2024 秋冬系列
- The Row 经典羊绒
- COS 极简针织

### 设计语言
- 哑光质地 · 暗色调子
- 微落肩 + 罗纹收口
- 单一针法不混织

DESIGN.md 格式示例

---
color_surface_yellow: "#F4D35E"
color_surface_purple: "#9B5DE5"
font_family_display: "SF Pro Display"
font_size_display: 56
radius_md: 16
state_focus_ring: "0 0 0 3px rgba(155, 93, 229, 0.40)"
---

# 主题色 · 马卡龙糖果色
- primary (#9B5DE5) 占 70%
- highlight (#FFE066) 占 15%
- text (#1A1A1A) 占 10%

read API 端点(scope=read)

methodpath说明
GET/api/tastes列表(分页、按 tag 过滤)— 已落地
GET/api/tastes/:id当前态详情 — 已落地

scope=read 的 key 不能写。返回 401(未带 key)或 403(write-only 写操作)。

申请 read key

走邀请流程:admin 在 /admin/invitations 生成邀请 → 你接受 → 登录后在 /settings/api-keys 申请 read API key(scope 锁定为 read)。