GET
/api/health
健康检查
查看最近同步的机型数量与时间
返回: ok, lastSyncCount, lastSyncAt
GET
/api/fold-models
关键词筛选
按关键词匹配折叠屏机型, 不传则使用内置默认关键词
| 参数 | 说明 |
|---|---|
keywords | 可选, 逗号分隔, 如 Mate X,Magic V |
返回: keywords, total, data[]
GET
/api/fold-models/verify
打分判定
test-model 打分策略识别横向大折机型, 输出置信度与理由
| 参数 | 说明 |
|---|---|
min | 可选, 1|true|yes 时仅返回精简字段 |
返回: strategy, total, data[]
GET
/api/fold-models/data
数据查看/下载
查看或下载折叠屏机型数据 (fold-models.min.json 同构, 动态生成)
返回: JSON: model, brand, modelName
参数: download=1 时以文件形式下载, 默认直接返回 JSON
GET
/api/models
机型查询
按品牌/型号精确或模糊匹配查询全量机型数据
| 参数 | 说明 |
|---|---|
brand | 品牌, 如 华为 |
model | 型号, 如 Mate X5 |
brand_match | fuzzy|exact, 默认 fuzzy |
model_match | fuzzy|exact, 默认 fuzzy |
limit | 返回条数上限, 默认 100, 最大 500 |
返回: query, total, data[]
POST
/api/sync
手动同步
触发一次数据同步; 配置 SYNC_TOKEN 时需请求头 x-sync-token
| 参数 | 说明 |
|---|---|
x-sync-token | 请求头, 鉴权令牌 |
返回: ok, synced, skipped, changed