💰 Skywalk Credits

商户积分系统 — API 服务

公共 API（Shopify App 调用）

方法路径说明
GET/api/public/credits/balance查询余额
GET/api/public/credits/transactions查询流水
POST/api/public/credits/apply申请积分
PATCH/api/public/credits/apply/:id回填工单 ID
POST/api/public/credits/deduct扣费（Phase 2）
POST/api/public/credits/refund退款（Phase 2）

鉴权：Header x-api-key

审核 API（admin 调用）

方法路径说明
GET/api/admin/applications申请列表
GET/api/admin/applications/:id申请详情
POST/api/admin/applications/:id/approve审核通过
POST/api/admin/applications/:id/reject审核驳回

鉴权：Authorization: Bearer JWT 或 ?token=review_token

内部 API（工单系统调用）

方法路径说明
POST/api/internal/review-tokens请求审核 token（邮件链接用）

鉴权：Header x-internal-token

审核页（邮件链接）

方法路径说明
GET/POST/review/:token邮件审核确认页

架构对标 skywalk-tickets · admin 通过 queryApp("credits", sql) 直连库