Files
qnc-server-v3/app/main/api/desc/front/app.api
2026-05-23 16:13:30 +08:00

71 lines
1.2 KiB
Plaintext

syntax = "v1"
info (
title: "APP服务"
desc: "APP服务"
version: "v1"
)
@server (
prefix: api/v1
group: app
)
service main {
@doc (
summary: "心跳检测接口"
)
@handler healthCheck
get /health/check returns (HealthCheckResp)
@handler getAppVersion
get /app/version returns (getAppVersionResp)
@handler getAppConfig
get /app/config returns (getAppConfigResp)
@handler getHomeDynamicData
get /app/home/dynamic (getHomeDynamicDataReq) returns (getHomeDynamicDataResp)
}
type (
getHomeDynamicDataReq {
LastId int64 `json:"lastId,optional"`
}
InquiryRecordItem {
Id int64 `json:"id"`
Tag string `json:"tag"`
Vin string `json:"vin"`
Model string `json:"model"`
}
ReviewItem {
Name string `json:"name"`
Content string `json:"content"`
}
getHomeDynamicDataResp {
Cases []InquiryRecordItem `json:"cases"`
Reviews []ReviewItem `json:"reviews"`
}
)
type (
// 心跳检测响应
HealthCheckResp {
Status string `json:"status"` // 服务状态
Message string `json:"message"` // 状态信息
}
)
type (
getAppVersionResp {
Version string `json:"version"`
WgtUrl string `json:"wgtUrl"`
}
)
type (
getAppConfigResp {
QueryRetentionDays int64 `json:"query_retention_days"`
}
)