---
id: "zh/api-post-nd-api-file-copy"
title: "拷贝文件"
language: "zh"
description: "POST /nd/api/file/copy：拷贝文件 接口说明，包含路径、方法、参数和返回信息。"
canonical_url: "https://www.babel.cc/public/babelwiki/zh/api-post-nd-api-file-copy.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/zh/api-post-nd-api-file-copy.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-file-copy.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-post-nd-api-file-copy.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# 拷贝文件

`POST /nd/api/file/copy`

## POST 请求体参数

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `file_ids` | `ID collection` | 必填；要复制的文件 ID 集合 |
| `target_id` | `string` | 必填；目标目录 ID |

## 返回信息

原文列出的字段：`code`, `success`, `copyKey`, `fileNum`.

源 PDF 对 file_ids 同时使用“数组”与 string 表述，序列化方式需与部署端确认。请求成功返回 copyKey，后续调用 copy_progress 查询完成情况，不应把请求受理当作复制完成。

## 调用说明

使用 `Authorization: Bearer <access_token>`。GET 参数放在 URL 查询串中，普通业务 POST 使用 JSON 请求体。先校验 HTTP 状态，再检查业务结果。数组标记与含糊的类型应按服务端实际约定联调，不应凭示例补造字段。

[认证说明](https://www.babel.cc/public/babelwiki/zh/developer-api-auth.html) · [API 概览](https://www.babel.cc/public/babelwiki/zh/developer-api-overview.html)