【文件夹】移动表单到文件夹

将指定的表单归档移动到某个文件夹中，或移出文件夹归入未分类根目录。

接口基本信息

• 接口路径：/open/v2/form/folder/move
• 请求方法：POST
• 请求格式：application/json
• 认证方式：HTTP Basic Auth (Authorization: Basic <base64(appId:appSecret)>)
• 幂等支持：支持 X-Idempotency-Key 请求头
• 并发控制：服务端已对目标 formKey 加锁保护

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

请求调用示例

场景 1：移动到指定文件夹

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

{
  "formKey": "ICGqvdBR",
  "folderId": 1001
}

场景 2：移出文件夹归入根目录 (folderId: 0)

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

{
  "formKey": "ICGqvdBR",
  "folderId": 0
}

响应参数说明 (Response Body)

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": true
}