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)
| method | path | 说明 |
|---|---|---|
| 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)。