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"}'