生成兑奖二维码 - 问答抽奖系统

调用此接口需要保证：

项目状态为进行中(status=1)

用户本地有中奖记录

二维码中的内容为用户兑奖界面的网页url，形如：

https://qarfl.rrrexyz.icu/claim-prize?project_uuid=1820380e-22d0-4f68-97ed-bd49f563100b&user_uuid=2fcfa550-d93b-11ef-a2a9-832c32728689&prize_raffled=1&prize_raffled=2&prize_raffled=3

以查询参数的形式传递项目和用户uuid，以及中奖奖品的id数组。数组是以同名参数的形式传递的，多个奖品id以&分隔。

此二维码url不存入数据库，前端需要在本地存储，用于展示用户兑奖二维码。

请求参数

Body 参数application/json

project_uuid

string

Project Uuid

必需

项目UUID

user_uuid

User Uuid

可选

用户UUID

Any of

string

null

prize_raffled

array[integer]

Prize Raffled

可选

用户抽到的所有奖品的id数组

示例

{
    "prize_raffled": [
        1,
        2,
        3
    ],
    "project_uuid": "1820380e-22d0-4f68-97ed-bd49f563100b",
    "user_uuid": "2fcfa550-d93b-11ef-a2a9-832c32728689"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200返回用户兑奖二维码信息

application/json

Body

project_uuid

string <uuid>

Project Uuid

必需

项目UUID

user_uuid

string <uuid>

User Uuid

必需

用户UUID

qr_code_url

string

Qr Code Url

必需

用户兑奖二维码URL，其中包含的内容就是claim_prize_url

claim_prize_url

string

Claim Prize Url

必需

用户兑奖链接

示例

{
    "claim_prize_url": "https://qarfl.rrrexyz.icu/claim-prize?project_uuid=1820380e-22d0-4f68-97ed-bd49f563100b&user_uuid=2fcfa550-d93b-11ef-a2a9-832c32728689&prize_raffled=1&prize_raffled=2&prize_raffled=3",
    "project_uuid": "1820380e-22d0-4f68-97ed-bd49f563100b",
    "qr_code_url": "https://dummyimage.com/400x300",
    "user_uuid": "2fcfa550-d93b-11ef-a2a9-832c32728689"
}

🟠400奖品不能为空

🟠404项目不存在

🟠422Validation Error