GET_DRAFT API 接口文档

接口信息

GET /openapi/capcut-mate/v1/get_draft

功能描述

获取草稿文件列表。该接口用于获取指定草稿ID对应的所有文件列表，可以查看草稿中包含的素材文件、配置文件等信息。通常用于草稿内容的预览、文件管理或状态检查。

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

Query参数

参数名类型必填默认值说明
draft_idstring✅-草稿ID，长度为20-32位字符

参数详解

draft_id
  • 类型: 字符串
  • 必填: 是
  • 长度: 20-32位字符
  • 格式: 通常为UUID格式或类似的唯一标识符
  • 示例: 2f52a63b-8c6a-4417-8b01-1b2a569ccb6c
  • 获取方式: 通常从draft_url中提取或由create_draft接口返回

响应格式

成功响应 (200)

{
  "files": [
    "2f52a63b-8c6a-4417-8b01-1b2a569ccb6c.json",
    "video_123456789.mp4",
    "audio_987654321.mp3",
    "image_555666777.jpg",
    "thumbnail_888999000.png"
  ]
}

响应字段说明

字段名类型说明
filesarray草稿相关的文件列表

错误响应 (4xx/5xx)

{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 基本获取草稿文件列表
curl -X GET "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2f52a63b-8c6a-4417-8b01-1b2a569ccb6c" \
  -H "Content-Type: application/json"
2. 使用完整的draft_id
curl -X GET "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=7e8f9a0b-1c2d-3e4f-5g6h-7i8j9k0l1m2n" \
  -H "Content-Type: application/json"

错误码说明

错误码错误信息说明解决方案
400draft_id是必填项缺少draft_id参数提供有效的draft_id
400draft_id长度无效draft_id长度不在20-32位范围内检查draft_id格式是否正确
400draft_id格式无效draft_id格式不正确确保使用正确的草稿ID格式
404草稿不存在指定的草稿ID无法找到确认草稿ID是否正确且存在
500获取文件列表失败内部服务错误联系技术支持或稍后重试
503服务不可用系统维护中稍后重试

注意事项

  1. 参数格式: 确保draft_id格式正确且长度在20-32位之间
  2. ID提取: 从draft_url正确提取draft_id
  3. 文件类型: 返回的文件列表包含多种类型的文件
  4. 权限验证: 确保有权限访问指定的草稿
  5. 实时性: 文件列表可能不是实时更新的，存在一定延迟
  6. 文件状态: 列表中的文件可能处于不同的处理状态

工作流程

  1. 验证draft_id参数
  2. 检查draft_id格式和长度
  3. 查找指定的草稿
  4. 获取草稿关联的所有文件
  5. 返回文件列表

相关接口

📚 项目资源
GitHub项目名称: capcut-mate

标签: API接口, 视频编辑, 剪映API, 草稿文件列表, GET_DRAFT

添加新评论