Information Collection User Submission Records

Interface Description

1、分页查询某个信息采集的观众提交记录
2、属于信息采集详情的一部分
3、接口支持https协议

Interface URL

http://api.polyv.net/live/v4/user/info-collection/submission/list

Online API Call

Request Method

GET

Interface Constraints

1. The interface supports both HTTP and HTTPS. HTTPS is recommended to ensure interface security. Interface calls have frequency limits. See details

Request Parameter Description

Example

http://api.polyv.net/live/v4/user/info-collection/submission/list?appId=xxx&sign=xxx&timestamp=xxx&formId=52&pageNumber=1&pageSize=10

Response Parameter Description

data Field Description

contents Field Description

After editing the form and adding new fields, the key for the new field will be missing from the fieldData of historical submission records. When retrieving values, display "-".

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. The test cases include HttpUtil.java and LiveSignUtil.java in the downloaded file.

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

private static final Logger log = LoggerFactory.getLogger(LiveInteractionTest.class);
/**
 * 信息采集用户提交记录
 * @throws IOException
 */
@Test
public void testListInfoCollectionSubmission() throws IOException, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String appId=super.appId;
    String appSecret=super.appSecret;
    String timestamp=String.valueOf(System.currentTimeMillis());
    //业务参数
    String formId = "52";
    String url = "http://api.polyv.net/live/v4/user/info-collection/submission/list";

    //http 调用逻辑
    Map<String,String> requestMap = new HashMap<>();
    requestMap.put("appId", appId);
    requestMap.put("timestamp",timestamp);
    requestMap.put("formId",formId);
    requestMap.put("pageNumber","1");
    requestMap.put("pageSize","10");
    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": {
        "pageNumber": 1,
        "pageSize": 10,
        "totalItems": 1,
        "totalPages": 1,
        "contents": [
            {
                "submissionId": 9001,
                "formId": 52,
                "bindingId": 88,
                "viewerId": "2_x3x8740mh7zo5i5w0or9z737s1a3g7my",
                "name": "张三",
                "mobile": "13800000000",
                "email": "",
                "viewerNickName": "小张",
                "viewerAvatar": "https://example.com/avatar.png",
                "fieldData": "{\"name_a1b2c3\":\"张三\",\"mobile_d4e5f6\":\"13800000000\"}",
                "privacyChecked": "[]",
                "createTime": "2026-07-01 13:00:00"
            }
        ]
    }
}

Error Example

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