mirror of
https://github.com/Hommy-master/capcut-mate.git
synced 2026-08-28 23:27:50 +08:00
Hommy
125 lines
3.2 KiB
Markdown
125 lines
3.2 KiB
Markdown
# SAVE_DRAFT API 接口文档
|
|
|
|
## 🌐 语言切换
|
|
[中文版](./save_draft.zh.md) | [English](./save_draft.md)
|
|
|
|
## 接口信息
|
|
|
|
```
|
|
POST /openapi/capcut-mate/v1/save_draft
|
|
```
|
|
|
|
## 功能描述
|
|
|
|
保存剪映草稿。该接口用于保存当前的草稿状态，确保编辑的内容得到持久化存储。通常在完成一系列编辑操作后调用此接口，以防止编辑内容丢失。
|
|
|
|
## 更多文档
|
|
|
|
📖 更多详细文档和教程请访问：[https://docs.jcaigc.cn](https://docs.jcaigc.cn)
|
|
|
|
## 请求参数
|
|
|
|
```json
|
|
{
|
|
"draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
|
|
}
|
|
```
|
|
|
|
### 参数说明
|
|
|
|
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|
|
|--------|------|------|--------|------|
|
|
| draft_url | string | ✅ | - | 要保存的草稿URL |
|
|
|
|
### 参数详解
|
|
|
|
#### draft_url
|
|
|
|
- **类型**: 字符串
|
|
- **必填**: 是
|
|
- **格式**: 完整的草稿URL，通常由create_draft接口返回
|
|
- **示例**: `https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258`
|
|
|
|
## 响应格式
|
|
|
|
### 成功响应 (200)
|
|
|
|
```json
|
|
{
|
|
"draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
|
|
}
|
|
```
|
|
|
|
### 响应字段说明
|
|
|
|
| 字段名 | 类型 | 说明 |
|
|
|--------|------|------|
|
|
| draft_url | string | 保存后的草稿URL，通常与请求中的URL相同 |
|
|
|
|
### 错误响应 (4xx/5xx)
|
|
|
|
```json
|
|
{
|
|
"detail": "错误信息描述"
|
|
}
|
|
```
|
|
|
|
## 使用示例
|
|
|
|
### cURL 示例
|
|
|
|
#### 1. 基本保存草稿
|
|
|
|
```bash
|
|
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/save_draft \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
|
|
}'
|
|
```
|
|
|
|
## 错误码说明
|
|
|
|
| 错误码 | 错误信息 | 说明 | 解决方案 |
|
|
|--------|----------|------|----------|
|
|
| 400 | draft_url是必填项 | 缺少草稿URL参数 | 提供有效的draft_url |
|
|
| 400 | draft_url格式无效 | URL格式不正确 | 检查URL格式是否正确 |
|
|
| 404 | 草稿不存在 | 指定的草稿无法找到 | 确认草稿URL是否正确且存在 |
|
|
| 500 | 保存失败 | 内部服务错误 | 联系技术支持或稍后重试 |
|
|
| 503 | 服务不可用 | 系统维护中 | 稍后重试 |
|
|
|
|
## 注意事项
|
|
|
|
1. **URL有效性**: 确保传入的draft_url是有效且存在的
|
|
2. **网络稳定性**: 保存操作需要稳定的网络连接
|
|
3. **频率控制**: 避免过于频繁的保存操作
|
|
4. **并发安全**: 同一草稿的并发保存可能导致冲突
|
|
|
|
## 工作流程
|
|
|
|
1. 验证draft_url参数
|
|
2. 检查草稿是否存在
|
|
3. 获取当前草稿状态
|
|
4. 持久化保存草稿数据
|
|
5. 返回保存结果
|
|
|
|
## 相关接口
|
|
|
|
- [创建草稿](./create_draft.md)
|
|
- [添加视频](./add_videos.md)
|
|
- [添加音频](./add_audios.md)
|
|
- [添加图片](./add_images.md)
|
|
- [生成视频](./gen_video.md)
|
|
|
|
---
|
|
|
|
<div align="right">
|
|
|
|
📚 **项目资源**
|
|
**GitHub**: [https://github.com/Hommy-master/capcut-mate](https://github.com/Hommy-master/capcut-mate)
|
|
**Gitee**: [https://gitee.com/taohongmin-gitee/capcut-mate](https://gitee.com/taohongmin-gitee/capcut-mate)
|
|
|
|
</div>
|
|
|
|
### 语言切换
|
|
[中文版](./save_draft.zh.md) | [English](./save_draft.md) |