elonX/docs/swagger.yaml
2025-02-20 16:47:08 +08:00

265 lines
6.7 KiB
YAML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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"