elonX/docs/swagger.yaml

265 lines
6.7 KiB
YAML
Raw Permalink Normal View History

2025-02-20 16:47:08 +08:00
definitions:
dapi.ResponseCommon:
properties:
code:
description: 返回Code 200 成功 其他是失败
type: integer
count:
description: 条数
type: integer
message:
description: 返回信息
type: object
login.SsoLoginParams:
properties:
mobile:
description: 登陆手机号
type: string
passWord:
description: 密码
type: string
type: object
login.SsoLoginResponse:
properties:
code:
description: 返回Code 200 成功 其他是失败
type: integer
count:
description: 条数
type: integer
data:
description: 数据列表
properties:
token:
description: 返回token
type: string
type: object
message:
description: 返回信息
type: object
login.SsoRegisterParams:
properties:
captcha:
description: 验证码
type: string
email:
description: 邮箱(可选)
type: string
invite:
description: 邀请码(可选)
type: string
mobile:
description: 手机号
type: string
password:
description: 密码
type: string
type: object
login.SsoRegisterResponse:
properties:
code:
description: 返回Code 200 成功 其他是失败
type: integer
count:
description: 条数
type: integer
data:
properties:
token:
type: string
type: object
message:
description: 返回信息
type: object
login.SsoSendSmsCodeParams:
properties:
mobile:
type: string
type: object
model.ExtraConfig:
type: object
model.UserConfig:
properties:
createTime:
description: 创建时间戳
type: integer
defaultSize:
allOf:
- $ref: '#/definitions/model.UserConfigChild'
description: 默认尺寸配置,存储长、宽、高、重量等
enableBlacklistFilter:
description: 是否启用违禁词过滤
type: string
enableDeduplication:
description: 是否启用去重检查
type: string
exchangeRates:
allOf:
- $ref: '#/definitions/model.UserConfigChild'
description: 汇率配置,存储不同货币的汇率
extraConfig:
allOf:
- $ref: '#/definitions/model.ExtraConfig'
description: 额外的扩展配置
fixedStock:
description: 固定库存值NULL 表示未设置
type: integer
id:
description: 用户配置ID
type: integer
importSource:
description: 导入方式
type: string
minStock:
description: 最小库存,低于该库存不允许上品
type: integer
priceMultiplier:
description: 上品价格上浮倍率
type: number
uid:
description: 用户ID关联用户表
type: integer
updateTime:
description: 更新时间戳
type: integer
type: object
model.UserConfigChild:
properties:
data:
items:
properties:
code:
type: string
num:
type: number
unit:
type: string
type: object
type: array
type: object
userConfig.GetUserConfigResponse:
properties:
code:
description: 返回Code 200 成功 其他是失败
type: integer
count:
description: 条数
type: integer
data:
type: object
message:
description: 返回信息
type: object
userConfig.UpdUserConfigParams:
properties:
data:
$ref: '#/definitions/model.UserConfig'
type: object
info:
contact: {}
paths:
/api/v1/login/captcha:
post:
consumes:
- application/json
description: 该接口用于发送短信验证码,限制验证码的发送频率和每天发送的次数。
parameters:
- description: 发送短信验证码的请求参数
in: body
name: body
required: true
schema:
$ref: '#/definitions/login.SsoSendSmsCodeParams'
produces:
- application/json
responses:
"200":
description: 短信验证码发送成功
schema:
$ref: '#/definitions/dapi.ResponseCommon'
summary: 发送短信验证码
tags:
- sms
/api/v1/login/login:
post:
consumes:
- application/json
description: 该接口用于用户通过手机号和密码进行登录。如果登录失败,系统会记录错误信息并限制登录次数。
parameters:
- description: 用户登录信息
in: body
name: body
required: true
schema:
$ref: '#/definitions/login.SsoLoginParams'
produces:
- application/json
responses:
"200":
description: 登录成功返回Token
schema:
$ref: '#/definitions/login.SsoLoginResponse'
summary: 用户登录
tags:
- login
/api/v1/login/register:
post:
consumes:
- application/json
description: 该接口用于用户通过手机号、密码、验证码等信息进行注册。如果注册成功返回用户的Token。
parameters:
- description: 用户注册信息
in: body
name: body
required: true
schema:
$ref: '#/definitions/login.SsoRegisterParams'
produces:
- application/json
responses:
"200":
description: 注册成功返回Token
schema:
$ref: '#/definitions/login.SsoRegisterResponse'
summary: 用户注册
tags:
- register
/api/v1/user/config/get:
post:
consumes:
- application/json
description: 获取商户自定义的配置
produces:
- application/json
responses:
"200":
description: 成功返回商户的配置信息
schema:
$ref: '#/definitions/userConfig.GetUserConfigResponse'
summary: 查看商户自定义配置
tags:
- 商户配置
/api/v1/user/config/upd:
post:
consumes:
- application/json
description: 更新商户的配置信息
parameters:
- description: TBD
in: body
name: body
required: true
schema:
$ref: '#/definitions/userConfig.UpdUserConfigParams'
produces:
- application/json
responses:
"200":
description: TBD
schema:
$ref: '#/definitions/dapi.ResponseCommon'
summary: 修改商户自定义配置
tags:
- 商户配置
swagger: "2.0"