Blizzard
344 lines
7.5 KiB
Plaintext
344 lines
7.5 KiB
Plaintext
syntax = "v1"
|
|
|
|
info (
|
|
title: "植物业务服务API"
|
|
desc: "我的植物、百科、社区、OCR、兑换、AI等HTTP接口"
|
|
author: "sundynix"
|
|
version: "v1.0.0"
|
|
)
|
|
|
|
type (
|
|
// ---------- 通用 ----------
|
|
IdReq {
|
|
Id string `json:"id"`
|
|
}
|
|
IdPathReq {
|
|
Id string `path:"id"`
|
|
}
|
|
IdsReq {
|
|
Ids []string `json:"ids"`
|
|
}
|
|
PageReq {
|
|
Current int `json:"current,optional"`
|
|
PageSize int `json:"pageSize,optional"`
|
|
Keyword string `json:"keyword,optional"`
|
|
}
|
|
// ---------- 我的植物 ----------
|
|
CreatePlantReq {
|
|
Name string `json:"name"`
|
|
PlantTime string `json:"plantTime"`
|
|
Status int `json:"status,optional"`
|
|
Placement string `json:"placement,optional"`
|
|
PotMaterial string `json:"potMaterial,optional"`
|
|
PotSize string `json:"potSize,optional"`
|
|
Sunlight string `json:"sunlight,optional"`
|
|
PlantingMaterial string `json:"plantingMaterial,optional"`
|
|
ImgIds []string `json:"imgIds,optional"`
|
|
}
|
|
UpdatePlantReq {
|
|
Id string `json:"id"`
|
|
Name string `json:"name,optional"`
|
|
Status int `json:"status,optional"`
|
|
Placement string `json:"placement,optional"`
|
|
PotMaterial string `json:"potMaterial,optional"`
|
|
PotSize string `json:"potSize,optional"`
|
|
Sunlight string `json:"sunlight,optional"`
|
|
PlantingMaterial string `json:"plantingMaterial,optional"`
|
|
ImgIds []string `json:"imgIds,optional"`
|
|
}
|
|
PlantListReq {
|
|
Current int `json:"current,optional"`
|
|
PageSize int `json:"pageSize,optional"`
|
|
Name string `json:"name,optional"`
|
|
}
|
|
// ---------- 养护计划 ----------
|
|
CarePlanReq {
|
|
PlantId string `json:"plantId"`
|
|
Name string `json:"name"`
|
|
Icon string `json:"icon,optional"`
|
|
TargetAction string `json:"targetAction"`
|
|
Period int `json:"period"`
|
|
}
|
|
// ---------- 养护记录 ----------
|
|
CareRecordReq {
|
|
PlantId string `json:"plantId"`
|
|
PlanId string `json:"planId"`
|
|
Action string `json:"action"`
|
|
Note string `json:"note,optional"`
|
|
}
|
|
// ---------- 成长记录 ----------
|
|
GrowthRecordReq {
|
|
PlantId string `json:"plantId"`
|
|
Content string `json:"content,optional"`
|
|
ImgIds []string `json:"imgIds,optional"`
|
|
}
|
|
// ---------- 百科 ----------
|
|
WikiListReq {
|
|
Current int `json:"current,optional"`
|
|
PageSize int `json:"pageSize,optional"`
|
|
Name string `json:"name,optional"`
|
|
ClassId string `json:"classId,optional"`
|
|
IsHot int `json:"isHot,optional"`
|
|
}
|
|
WikiClassReq {
|
|
Name string `json:"name"`
|
|
Icon string `json:"icon,optional"`
|
|
}
|
|
// ---------- 帖子 ----------
|
|
CreatePostReq {
|
|
Title string `json:"title"`
|
|
Content string `json:"content"`
|
|
Location string `json:"location,optional"`
|
|
ImgIds []string `json:"imgIds,optional"`
|
|
TopicId string `json:"topicId,optional"`
|
|
}
|
|
PostListReq {
|
|
Current int `json:"current,optional"`
|
|
PageSize int `json:"pageSize,optional"`
|
|
Keyword string `json:"keyword,optional"`
|
|
TopicId string `json:"topicId,optional"`
|
|
}
|
|
PostCommentReq {
|
|
PostId string `json:"postId"`
|
|
Content string `json:"content"`
|
|
ParentId string `json:"parentId,optional"`
|
|
}
|
|
// ---------- 话题 ----------
|
|
TopicReq {
|
|
Name string `json:"name"`
|
|
Icon string `json:"icon,optional"`
|
|
Desc string `json:"desc,optional"`
|
|
}
|
|
// ---------- OCR ----------
|
|
OcrReq {
|
|
ImageUrl string `json:"imageUrl"`
|
|
}
|
|
// ---------- 兑换 ----------
|
|
ExchangeItemListReq {
|
|
Current int `json:"current,optional"`
|
|
PageSize int `json:"pageSize,optional"`
|
|
}
|
|
ExchangeOrderReq {
|
|
ItemId string `json:"itemId"`
|
|
}
|
|
// ---------- AI ----------
|
|
AiChatReq {
|
|
Question string `json:"question"`
|
|
}
|
|
// ---------- 用户资料 ----------
|
|
UpdateProfileReq {
|
|
Nickname string `json:"nickname,optional"`
|
|
AvatarId string `json:"avatarId,optional"`
|
|
}
|
|
// ---------- 等级/徽章配置 ----------
|
|
LevelConfigListReq {
|
|
Current int `json:"current,optional"`
|
|
PageSize int `json:"pageSize,optional"`
|
|
}
|
|
BadgeConfigListReq {
|
|
Current int `json:"current,optional"`
|
|
PageSize int `json:"pageSize,optional"`
|
|
Dimension string `json:"dimension,optional"`
|
|
}
|
|
)
|
|
|
|
// ========== 无需鉴权 ==========
|
|
@server (
|
|
prefix: /api/plant
|
|
group: callback
|
|
)
|
|
service plant-api {
|
|
@doc "微信支付回调"
|
|
@handler WechatPayCallback
|
|
post /callback/wechatpay
|
|
}
|
|
|
|
// ========== 需要鉴权 ==========
|
|
@server (
|
|
prefix: /api/plant
|
|
group: myPlant
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "创建植物"
|
|
@handler CreatePlant
|
|
post /my/create (CreatePlantReq)
|
|
|
|
@doc "更新植物"
|
|
@handler UpdatePlant
|
|
put /my/update (UpdatePlantReq)
|
|
|
|
@doc "删除植物"
|
|
@handler DeletePlant
|
|
delete /my/delete (IdsReq)
|
|
|
|
@doc "我的植物列表"
|
|
@handler GetMyPlantList
|
|
post /my/list (PlantListReq)
|
|
|
|
@doc "植物详情"
|
|
@handler GetPlantDetail
|
|
get /my/:id (IdPathReq)
|
|
|
|
@doc "添加养护计划"
|
|
@handler AddCarePlan
|
|
post /my/carePlan (CarePlanReq)
|
|
|
|
@doc "添加养护记录"
|
|
@handler AddCareRecord
|
|
post /my/careRecord (CareRecordReq)
|
|
|
|
@doc "添加成长记录"
|
|
@handler AddGrowthRecord
|
|
post /my/growthRecord (GrowthRecordReq)
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: wiki
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "百科列表"
|
|
@handler GetWikiList
|
|
post /wiki/list (WikiListReq)
|
|
|
|
@doc "百科详情"
|
|
@handler GetWikiDetail
|
|
get /wiki/:id (IdPathReq)
|
|
|
|
@doc "百科分类列表"
|
|
@handler GetWikiClassList
|
|
get /wiki/class/list
|
|
|
|
@doc "创建百科分类"
|
|
@handler CreateWikiClass
|
|
post /wiki/class/create (WikiClassReq)
|
|
|
|
@doc "收藏/取消收藏百科"
|
|
@handler ToggleWikiStar
|
|
post /wiki/star (IdReq)
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: post
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "发布帖子"
|
|
@handler CreatePost
|
|
post /post/create (CreatePostReq)
|
|
|
|
@doc "帖子列表"
|
|
@handler GetPostList
|
|
post /post/list (PostListReq)
|
|
|
|
@doc "帖子详情"
|
|
@handler GetPostDetail
|
|
get /post/:id (IdPathReq)
|
|
|
|
@doc "删除帖子"
|
|
@handler DeletePost
|
|
delete /post/delete (IdsReq)
|
|
|
|
@doc "评论帖子"
|
|
@handler CommentPost
|
|
post /post/comment (PostCommentReq)
|
|
|
|
@doc "点赞帖子"
|
|
@handler LikePost
|
|
post /post/like (IdReq)
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: topic
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "话题列表"
|
|
@handler GetTopicList
|
|
get /topic/list
|
|
|
|
@doc "创建话题"
|
|
@handler CreateTopic
|
|
post /topic/create (TopicReq)
|
|
|
|
@doc "删除话题"
|
|
@handler DeleteTopic
|
|
delete /topic/delete (IdsReq)
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: ocr
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "OCR植物识别"
|
|
@handler OcrClassify
|
|
post /ocr/classify (OcrReq)
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: exchange
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "兑换商品列表"
|
|
@handler GetExchangeItemList
|
|
post /exchange/list (ExchangeItemListReq)
|
|
|
|
@doc "兑换商品"
|
|
@handler CreateExchangeOrder
|
|
post /exchange/order (ExchangeOrderReq)
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: ai
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "AI问答"
|
|
@handler AiChat
|
|
post /ai/chat (AiChatReq)
|
|
|
|
@doc "聊天历史"
|
|
@handler GetAiChatHistory
|
|
get /ai/history
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: userProfile
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "获取用户资料"
|
|
@handler GetUserProfile
|
|
get /profile/info
|
|
|
|
@doc "更新用户资料"
|
|
@handler UpdateUserProfile
|
|
put /profile/update (UpdateProfileReq)
|
|
}
|
|
|
|
@server (
|
|
prefix: /api/plant
|
|
group: config
|
|
jwt: Auth
|
|
)
|
|
service plant-api {
|
|
@doc "等级配置列表"
|
|
@handler GetLevelConfigList
|
|
post /config/level/list (LevelConfigListReq)
|
|
|
|
@doc "徽章配置列表"
|
|
@handler GetBadgeConfigList
|
|
post /config/badge/list (BadgeConfigListReq)
|
|
}
|
|
|