@apicity/dropbox

中文文档
0.27.0发布于 2026/11/06MITTypeScriptES Module近 30 天下载 3649

Dropbox HTTP API 供用户,文件,内容上传/下載,并共享端点使用.

中文使用文档
文档目录9 节
  1. 安装
  2. 快速启动
  3. API 参考
  4. 检查
  5. 文件
  6. 欧斯2
  7. 共享
  8. 用户
  9. 许可证

@ apicity/ 收音机

npm dependencies TypeScript docs

Dropbox HTTP API 供用户,文件,内容上传/下載,并共享端点使用.

运行时间依赖性 :

  • zod@^4.6.6 - 请求在 Dropbox 端点方法上附加的策略如下: .schema

安装

npm install @apicity/dropbox
# or
pnpm add @apicity/dropbox

快速启动

import { createDropbox } from "@apicity/dropbox";

const dropbox = createDropbox({ oauthToken: process.env.DROPBOX_OAUTH_TOKEN! });

若为 oauthToken 被省略,提供者读取 DROPBOX_OAUTH_TOKEN 请求时间. 访问符只在 Authorization: Bearer ... 头曰.

oauth2.token 交换授权代码( 带有可选的 PKCE) code_verifier)或连接符的刷新符. 它要求 clientId 选项,添加 clientSecret 并且将补助金作为形式机构发放给 oauthBaseURL (默认) https://api.dropboxapi.com) (中文(简体) ).

API 参考

17个终点横跨5个组. 每个方法都映射出上游的 URL 路径 .

检查

POST dropbox.check.user

POST https://api.dropboxapi.com/2/check/user

成本等级 : cheap

上游区域

const res = await dropbox.check.user({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

文件

POST dropbox.files.copyV2

POST https://api.dropboxapi.com/2/files/copy_v2

成本等级 : cheap

上游区域

const res = await dropbox.files.copyV2({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.createFolderV2

POST https://api.dropboxapi.com/2/files/create_folder_v2

成本等级 : cheap

上游区域

const res = await dropbox.files.createFolderV2({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.deleteV2

POST https://api.dropboxapi.com/2/files/delete_v2

成本等级 : cheap

上游区域

const res = await dropbox.files.deleteV2({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.download

POST https://content.dropboxapi.com/2/files/download

成本等级 : cheap

上游区域

const res = await dropbox.files.download({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.getMetadata

POST https://api.dropboxapi.com/2/files/get_metadata

成本等级 : cheap

上游区域

const res = await dropbox.files.getMetadata({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.listFolder

POST https://api.dropboxapi.com/2/files/list_folder

成本等级 : cheap

上游区域

const res = await dropbox.files.listFolder({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.listFolderContinue

POST https://api.dropboxapi.com/2/files/list_folder/continue

成本等级 : cheap

上游区域

const res = await dropbox.files.listFolderContinue({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.moveV2

POST https://api.dropboxapi.com/2/files/move_v2

成本等级 : cheap

上游区域

const res = await dropbox.files.moveV2({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.upload

POST https://content.dropboxapi.com/2/files/upload

成本等级 : cheap

上游区域

const res = await dropbox.files.upload({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.uploadSession.appendV2

POST https://content.dropboxapi.com/2/files/upload_session/append_v2

成本等级 : cheap

上游区域

const res = await dropbox.files.uploadSession.appendV2({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.uploadSession.finish

POST https://content.dropboxapi.com/2/files/upload_session/finish

成本等级 : cheap

上游区域

const res = await dropbox.files.uploadSession.finish({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.files.uploadSession.start

POST https://content.dropboxapi.com/2/files/upload_session/start

成本等级 : cheap

上游区域

const res = await dropbox.files.uploadSession.start({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

欧斯2

POST dropbox.oauth2.token

POST https://api.dropboxapi.com/oauth2/token

成本等级 : cheap

上游区域

const res = await dropbox.oauth2.token({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

共享

POST dropbox.sharing.createSharedLinkWithSettings

POST https://api.dropboxapi.com/2/sharing/create_shared_link_with_settings

成本等级 : cheap

上游区域

const res = await dropbox.sharing.createSharedLinkWithSettings({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

POST dropbox.sharing.listSharedLinks

POST https://api.dropboxapi.com/2/sharing/list_shared_links

成本等级 : cheap

上游区域

const res = await dropbox.sharing.listSharedLinks({ /* ... */ });

资料来源: packages/provider/dropbox/src/dropbox.ts

用户

POST dropbox.users.getCurrentAccount

POST https://api.dropboxapi.com/2/users/get_current_account

成本等级 : cheap

上游区域

const res = await dropbox.users.getCurrentAccount();

资料来源: packages/provider/dropbox/src/dropbox.ts

部分 辣点 单相机.

许可证

麻省理工学院——见 自由主义。 。 。 .

版本与发布记录

@apicity/dropbox 共发布 54 个版本,首次发布于 2026/06/30;过去 12 个月发布了 54 个版本。

版本发布日期距今
0.27.0latest2026/11/06今天
0.26.02026/11/051 天前
0.25.02026/11/033 天前
0.24.12026/11/024 天前
0.24.02026/11/014 天前
0.23.12026/11/015 天前

关于 @apicity/dropbox 的常见问题

@apicity/dropbox 是什么?

Dropbox HTTP API 供用户,文件,内容上传/下載,并共享端点使用.

如何安装 @apicity/dropbox?

在项目目录运行 npm install @apicity/dropbox,或使用 pnpm add / yarn add / bun add。

@apicity/dropbox 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@apicity/dropbox 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@apicity/dropbox 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@apicity/dropbox 可以商用吗?

@apicity/dropbox 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@apicity/dropbox 的下载量有多少?

根据 npm 官方下载统计,@apicity/dropbox 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,649 次,日均约 122 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@apicity/dropbox 还在维护吗?

最新版本 0.27.0 发布于 2026/11/06(今天);至今共发布 54 个版本,其中过去 12 个月发布了 54 个;首次发布于 2026/06/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。