Batch Create Questionnaires (Supporting Multi-Channel Simultaneous Creation)

API Description

1、支持批量创建问卷（支持多频道同时创建）
2、（timestamp, appId）参与sign签名，并和sign一起通过url传递，请求体参数不参与签名，通过post请求体传递【请设置请求头contentType:application/json】
3、接口支持https协议

API URL

http://api.polyv.net/live/v4/channel/questionnaire/create-batch

Online API Call

Request Method

POST

API Constraints

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

Request Parameter Description

Request Body Parameter Description

questionnaires Field Description

questions Field Description

Example

https://api.polyv.net/live/v4/channel/questionnaire/create-batch?appId=frlr1zazn3&sign=439CDA1327558DFCF947F305D03AFA92&timestamp=1621843779393

Request Body Parameters

{
  "questionnaires": [
    {
      "questionnaireTitle": "这里是问卷标题",
      "channelId": 10002,
      "userTags": ["vip", "registered"],
      "autoPublishTime": "2025-04-31 08:00",
      "autoEndTime": "2025-04-31 08:30",
      "questions": [
        {
          "name": "题目名称qwe1",
          "type": "R",
          "answer": "A",
          "required": "Y",
          "options": ["选项1", "选项2", "选项3"]
        }
      ]
    },
    {
      "questionnaireTitle": "这里是问卷标题2",
      "channelId": 10003,
      "questions": [
        {
          "name": "题目名称qwe2",
          "type": "R",
          "answer": "B",
          "required": "Y",
          "scoreEnabled": "Y",
          "score": 10,
          "options": ["选项1", "选项2", "选项3"]
        }
      ]
    }
  ]
}

Response Parameter Description

data Field Description

questionnaires Field Description

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 in 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 testAddEditQuestionnaire() throws IOException, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String appId=super.appId;
    String appSecret=super.appSecret;
    String userId = super.userId;
    String timestamp=String.valueOf(System.currentTimeMillis());
    //业务参数
    String temp = "https://api.polyv.net/live/v4/channel/questionnaire/create-batch";

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

    String body = "{\"questionnaires\":[{\"questionnaireTitle\":\"这里是问卷标题\",\"channelId\":10002,\"userTags\":[\"vip\",\"registered\"],\"autoPublishTime\":\"2025-04-31 08:00\",\"autoEndTime\":\"2025-04-31 08:30\",\"questions\":[{\"name\":\"题目名称qwe1\",\"type\":\"R\",\"answer\":\"A\",\"required\":\"Y\",\"options\":[\"选项1\",\"选项2\",\"选项3\"]}]},{\"questionnaireTitle\":\"这里是问卷标题2\",\"channelId\":10003,\"questions\":[{\"name\":\"题目名称qwe2\",\"type\":\"R\",\"answer\":\"B\",\"required\":\"Y\",\"scoreEnabled\":\"Y\",\"score\":10,\"options\":[\"选项1\",\"选项2\",\"选项3\"]}]}]}";
    requestMap.put("sign",LiveSignUtil.getSign(requestMap, appSecret));
    String url = HttpUtil.appendUrl(temp,requestMap);
    String response = HttpUtil.postJsonBody(url, body, null);
    log.info("测试批量创建问卷接口返回值：{}",response);
    //do somethings
}

Response Example

See Global Error Description for system-wide error descriptions.

Success Example

{
  "code": 200,
  "status": "success",
  "requestId": "ed721ebb-9add-4469-ad0f-e46db8aac206",
  "data": {
    "questionnaires": [
      {
        "channelId": 10002,
        "questionnaireId": "h6mmyaxze1",
        "questionIds": ["feqfr13ftz"]
      },
      {
        "channelId": 10003,
        "questionnaireId": "h6mmyaxze2",
        "questionIds": ["feqfr13ft1"]
      }
    ]
  },
  "success": true
}

Error Example

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