问答抽奖系统
  1. 前台用户端
问答抽奖系统
  • 用户模块
    • 注册一个管理员账户
      POST
    • 登录账号
      POST
    • 当access_token过期时,用refresh_token获取新的access_token
      GET
    • 获取当前登录用户的信息
      GET
    • 谨慎:注销当前登录用户的账号。
      DELETE
  • 后台管理端
    • 创建项目
      POST
    • 创建项目
      POST
    • 编辑项目
      PUT
    • 删除项目
      DELETE
    • 获取项目详情
      GET
    • 获取当前账号的所有项目预览列表
      GET
    • 获取所有账号的所有项目预览列表
      GET
    • 生成参与项目用的二维码
      POST
    • 扫兑奖码返回用户中奖信息及是否已兑奖
      GET
    • 给用户兑奖
      POST
  • 前台用户端
    • 获取项目的问答题目
      GET
    • 获取项目的抽奖信息
      GET
    • 提交答案
      POST
    • 抽一次奖
      POST
    • 生成兑奖二维码
      POST
  1. 前台用户端

提交答案

POST
/api/answer
前台用户端
最后修改时间:2025-01-25 09:15:39
责任人:未设置
调用此接口需要保证:
1.
项目状态为进行中(status=1)
2.
用户答案数组长度与项目中题目数量一致
3.
用户本地无答题记录
调用后返回用户作答结果,用户答题情况不存入数据库,前端需要在本地存储,用于展示用户答题情况。

请求参数

Body 参数application/json
project_uuid
string 
Project Uuid
必需
项目UUID
user_answer
array[integer]
User Answer
必需
用户答案
示例
{
    "project_uuid": "1820380e-22d0-4f68-97ed-bd49f563100b",
    "user_answer": [
        2,
        1,
        4,
        3,
        2
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/answer' \
--header 'Content-Type: application/json' \
--data-raw '{
    "project_uuid": "1820380e-22d0-4f68-97ed-bd49f563100b",
    "user_answer": [
        2,
        1,
        4,
        3,
        2
    ]
}'

返回响应

🟢200返回用户作答结果信息
application/json
Body
project_uuid
string <uuid>
Project Uuid
必需
项目UUID
user_uuid
string <uuid>
User Uuid
必需
用户UUID
user_answer
array[integer]
User Answer
必需
用户提交的答案数组
correct_answer
array[integer]
Correct Answer
必需
正确答案数组
user_correct_num
integer 
User Correct Num
必需
用户答对的题目数量
total_item_num
integer 
Total Item Num
必需
题目总量
correct_rate
number 
Correct Rate
必需
用户正确率
示例
{
    "correct_answer": [
        2,
        1,
        3,
        3,
        2
    ],
    "correct_rate": 0.8,
    "project_uuid": "1820380e-22d0-4f68-97ed-bd49f563100b",
    "total_item_num": 5,
    "user_answer": [
        2,
        1,
        4,
        3,
        2
    ],
    "user_correct_num": 4,
    "user_uuid": "2fcfa550-d93b-11ef-a2a9-832c32728689"
}
🟠404项目不存在
🟠422Validation Error
修改于 2025-01-25 09:15:39
上一页
获取项目的抽奖信息
下一页
抽一次奖
Built with