Base

当前站点根路径 + 下列 API。管理接口需请求头 X-Admin-Key

公开 · 健康检查

GET /api/health

公开 · 商品列表(含库存)

GET /api/products

公开 · 兑换发货

POST /api/redeem Content-Type: application/json {"code":"UNICORN-XXXX-XXXX"} # 成功 {"ok":true,"product":{"id":1,"slug":"plus","name":"..."},"content":"发货内容","redeemed_at":"..."}

公开 · 查询状态(不消耗)

GET /api/query?code=UNICORN-XXXX-XXXX

管理 · 统计

GET /api/admin/stats X-Admin-Key: <key>

管理 · 商品 CRUD

GET /api/admin/products POST /api/admin/products {"slug":"plus","name":"Plus 月卡","description":""} PATCH /api/admin/products/{id} DELETE /api/admin/products/{id}

管理 · 导入卡密

POST /api/admin/cdks {"product_id":1,"items":[{"code":"A-1","content":"货品内容"}]} POST /api/admin/cdks/import-text {"product_id":1,"sep":"|","text":"A-1|货品内容\\nA-2|另一条"}

管理 · 卡密 / 兑换记录

GET /api/admin/cdks?product_id=&status=&limit=100 DELETE /api/admin/cdks/{id} GET /api/admin/redeems?limit=50

curl 示例

# 兑换 curl -sS -X POST https://unicorn.jiaopilot.com/api/redeem \ -H 'Content-Type: application/json' \ -d '{"code":"DEMO-0001"}' # 建商品 curl -sS -X POST https://unicorn.jiaopilot.com/api/admin/products \ -H 'Content-Type: application/json' \ -H 'X-Admin-Key: YOUR_KEY' \ -d '{"slug":"demo","name":"演示商品","description":"demo"}'