flask后端
  1. 设备操作
flask后端
  • 新版本api(已上线)
    • 网页信息操作
      • 添加网页信息
      • 修改网页信息
      • 查询网页信息
    • 学校操作
      • 添加学校
      • 查询学校信息
      • 修改学校信息
      • 删除学校
    • 管理员操作
      • 添加管理员
      • 删除管理员
      • 修改管理员信息
      • 查询管理员信息
      • 获取当前管理员信息
    • 年级操作
      • 添加年级
      • 查询年级信息
      • 修改年级信息
      • 删除年级
    • 班级操作
      • 添加班级
      • 查询班级信息
      • 修改班级信息
      • 删除班级
    • 学生操作
      • 添加学生
      • 查询学生信息
      • 修改学生信息
      • 删除学生
      • 导出学生
      • 发送更改到卡片
      • 发送开卡到卡片
      • 从读卡器读卡
      • 补卡操作
      • 生成24位学号
    • 设备操作
      • 添加设备
        POST
      • 查询设备信息
        GET
      • 修改设备信息
        PUT
      • 删除设备
        DELETE
      • 导出设备
        GET
    • 消费操作
      • 从机器消费
      • 消费记录查询
      • 导出消费记录
    • 充值操作
      • 从圈存机圈存消费
      • 电脑网页支付宝支付
      • 手机网页支付宝支付
      • 查询充值记录
      • 更改支付宝支付对象
      • 微信二维码支付
      • 更改微信支付对象
      • 导出充值记录
    • 修改金额操作
      • 修改卡片余额
      • 修改账户余额
      • 查询修改记录
      • 导出修改记录
    • 查询v2版(可能临时)
      • 查询学校信息v2
      • 查询年级信息v2
      • 查询班级信息v2
      • 查询学生信息v2
    • 管理员登录接口
      POST
    • 管理员登出接口
      POST
  1. 设备操作

添加设备

测试中
POST
https://selfxu.cn:5000/device_info/add
此接口用于添加设备,需要管理员有添加权限
name:设备名称
number:设备编号
school:设备所在学校(root必填,非root用户为本校)
type:设备类型(消费设备,圈存机,读卡机)
"billing_mode": "单次计费"(单次计费,连续计费)
"online": "在线设备"(在线设备,离线设备)
"billing_multiplier": 100,计费倍率,整数百分比形式
一个学校下设备编号不能重复,但学校和学校之间可以出现重复的设备编号,如"北大,设备1"和"清华,设备1",北大和清华下可以出现重复的名称,但如果试图向北大添加两个设备1则第二个设备1会被拒绝添加。

请求参数

Cookie 参数
token
string 
必需
示例值:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InJvb3QiLCJleHAiOjE3MTg5ODI1ODR9.lCoQhUMXdBJGnIPpYAwMvesjBBIKf8MDarYefQxYU_A
Body 参数application/json
object {0}
示例
{
    "name": "测试",
    "number": "测试_4",
    "type": "消费设备",
    "remark": "",
    "billing_mode": "单次计费",
    "online": "在线设备",
    "billing_multiplier": 100,
    "operation": "正常",
    "operation_expiry_date": "2029-06-21",
    "shore": "一教",
    "school": "北大"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://selfxu.cn:5000/device_info/add' \
--header 'Cookie: token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InJvb3QiLCJleHAiOjE3MTg5ODI1ODR9.lCoQhUMXdBJGnIPpYAwMvesjBBIKf8MDarYefQxYU_A' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "测试",
    "number": "测试_4",
    "type": "消费设备",
    "remark": "",
    "billing_mode": "单次计费",
    "online": "在线设备",
    "billing_multiplier": 100,
    "operation": "正常",
    "operation_expiry_date": "2029-06-21",
    "shore": "一教",
    "school": "北大"
}'

返回响应

🟢200成功
application/json
Body
data
object 
必需
billing_mode
string 
必需
id
string 
必需
name
string 
必需
number
string 
必需
online
string 
必需
operation
string 
必需
operation_expiry_date
string 
必需
remark
string 
必需
school
string 
必需
shore
string 
必需
type
string 
必需
message
string 
必需
status
string 
必需
示例
{
  "data": {
    "billing_mode": "不生效",
    "id": "75b0e6de-87b5-44b6-a00a-129b2cb83629",
    "name": "饮水机",
    "number": "饮水机_1",
    "online": "不生效",
    "operation": "正常",
    "operation_expiry_date": "2024-06-21T00:00:00",
    "remark": "",
    "school": "北大",
    "shore": "一教",
    "type": "消费设备"
  },
  "message": "设备添加成功",
  "status": "成功"
}
上一页
生成24位学号
下一页
查询设备信息
Built with