QX Garage · 门店 API v1

统一信封 {"ok":true,"data":...};金额单位「分」;鉴权 Authorization: Bearer <token>。 登录:POST /api/v1/auth/login {"phone":"13800000001","code":"123456"}(演示环境任意 6 位)。

方法路径说明
POST/api/v1/auth/login登录换 token
POST/api/v1/auth/logout注销
GET/api/v1/me当前员工 + 所属租户
GET/api/v1/t/{tid}/dashboard工作台数字(今日进场/待结算/30 天提醒/7 日曲线)
GET/api/v1/t/{tid}/settings门店信息 + 员工
PUT/api/v1/t/{tid}/settings改门店信息
GET/api/v1/t/{tid}/items价目表
POST/api/v1/t/{tid}/items新增项目
PATCH/api/v1/t/{tid}/items/{id}改价
GET/api/v1/t/{tid}/customers?q=&page=客户列表(搜姓名/手机)
GET/api/v1/t/{tid}/customers/{id}客户档案 + 车辆 + 历史工单
GET/api/v1/t/{tid}/vehicles/lookup?plate=粤B1000车牌带出客户与上次保养
GET/api/v1/t/{tid}/orders?status=工单列表
POST/api/v1/t/{tid}/orders接车开单
GET/api/v1/t/{tid}/orders/{no}工单详情
POST/api/v1/t/{tid}/orders/{no}/quote生成报价分享 token
POST/api/v1/t/{tid}/orders/{no}/confirm客户确认报价(演示)
PATCH/api/v1/t/{tid}/orders/{no}/status状态流转(不能跳步)
POST/api/v1/t/{tid}/orders/{no}/settle结算(自动写客户累计 + 下次保养提醒)
GET/api/v1/t/{tid}/reminders?month=2026-11到期提醒
POST/api/v1/t/{tid}/reminders/{id}标记已联系/已到店

错误码:VALIDATION 400 · UNAUTHORIZED 401 · TENANT_FORBIDDEN 403 · NOT_FOUND 404 · STATE_CONFLICT 409 · RATE_LIMIT 429