Query Channel Lottery Records

API Description

1、通过抽奖ID获取频道的单场抽奖的中奖用户列表
2、接口支持https协议

API URL

http://api.polyv.net/live/v3/channel/lottery/get-winner-detail

Online API Call

Request Method

GET

API Constraints

1. The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details

Request Parameters

Example

http://api.polyv.net/live/v3/channel/lottery/get-winner-detail?appId=frlr1zazn3&sign=A53A9A7DB3B88442E3F433F8219C1029&channelId=2191532&timestamp=1621844963404&lotteryId=fwqs12puef

Response Parameters

data Field Description

contents Field Description

WinnerRecordModelExt Field Description

Description: Extension information for winning records

ReceiveInfoFieldModel Field Description

Description: Prize claim information filled in for the winning record

Java Request Example

For quick integration of basic code, please download the relevant dependency source code. Click here to download the source code. After downloading, add it to your own source code project. HttpUtil.java and LiveSignUtil.java from the test cases are included in the downloaded file.

It is strongly recommended to use the Live Java SDK for API integration. The Live Java SDK provides unified encapsulation and optimization for API call logic, exception handling, data signing, and HTTP request thread pooling.

private static final Logger log = LoggerFactory.getLogger(LiveInteractionTest.class);

/**
 * 依查询频道场次中奖记录
 * @throws IOException
 */
@Test
public void testGetWinnerDetail() throws IOException, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String appId=super.appId;
    String appSecret=super.appSecret;
    String userId = super.userId;
    String timestamp=String.valueOf(System.currentTimeMillis());
    //业务参数
    String url = "http://api.polyv.net/live/v3/channel/lottery/get-winner-detail";
    String channelId = "1965681";
    String lotteryId = "fv3hogjmh3";

    //http 调用逻辑
    Map<String,String> requestMap = new HashMap<>();
    requestMap.put("appId", appId);
    requestMap.put("timestamp",timestamp);

    requestMap.put("channelId",channelId);
    requestMap.put("lotteryId",lotteryId);

    requestMap.put("sign",LiveSignUtil.getSign(requestMap, appSecret));
    String response = HttpUtil.get(url,requestMap);
    log.info("测试查询频道场次中奖记录接口返回值：{}",response);
    //do somethings

}

Response Example

For global system error descriptions, see Global Error Description

Success Example

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "pageSize": 10,
        "pageNumber": 1,
        "totalItems": 1,
        "contents": [{
            "recordId": "b20c0e091d",
            "channelId": 1965681,
            "lotteryId": "fv3hogjmh3",
            "sessionId": "fv3hmq3qml",
            "viewerId": "ovtl9twa7JHyHBBA8QUNVjjM4WIs",
            "viewerName": "王勋",
            "winnerCode": "wMpUjVSi",
            "prize": "10元现金红包",
            "name": null,
            "telephone": null,
            "createdTime": 1611127338000,
            "lastModified": 1611127338000,
            "address": null,
            "param4": "oi_ubsz8bujEA8TXdMzPpAxbC0ZI",
            "param5": null,
            "userId": "1b448be323",
            "ext": null
        }],
        "startRow": 1,
        "firstPage": true,
        "lastPage": true,
        "prePageNumber": 1,
        "limit": 1,
        "totalPages": 1,
        "nextPageNumber": 1,
        "endRow": 1,
        "offset": 0
    }
}

Error Example

{
    "code": 400,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}