【文件夹】创建文件夹

创建一级表单分类归档文件夹，方便在控制台对不同业务线、项目或部门的表单进行分类归集管理。

接口基本信息

• 接口路径：/open/v2/form/folder/create
• 请求方法：POST
• 请求格式：application/json
• 认证方式：HTTP Basic Auth (Authorization: Basic <base64(appId:appSecret)>)
• 幂等支持：支持 X-Idempotency-Key 请求头

请求参数详细说明 (Request Body)

请求调用示例

1. HTTP 报文请求

POST /tduck-api/open/v2/form/folder/create HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw==
X-Idempotency-Key: folder-create-2026082001

{
  "name": "2026年度业务数据收集"
}

2. cURL 命令行示例

curl -X POST "https://api.example.com/tduck-api/open/v2/form/folder/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw==" \
  -d '{"name": "2026年度业务数据收集"}'

响应参数说明 (Response Body)

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1001,
    "name": "2026年度业务数据收集",
    "createTime": "2026-08-20 09:40:00"
  }
}