DockDart API 接入说明

DockDart API。 读取公开产品信息。

查询产品资料、最新版本和官方下载地址。公开、免费、只读,无需 API Key。

开始查询

DockDart API 面向需要了解产品、比较功能或获取官方下载信息的 AI 助手、脚本和网站。它只提供公开产品资料,不读取用户文件、不操作 Mac、不激活许可证,也不发起付款。应用的浏览器标签页、文件和系统操作功能仍由用户在本机使用。

认证、费用与使用方式

接口公开、免费、只读,无需账户、API Key 或 OAuth。使用 HTTPS GET 查询,HEAD 只返回相同的状态码和响应头。浏览器可以跨域读取;不发送 Cookie 或凭据。产品信息支持 lang=en 和 lang=zh,默认英文;版本接口没有查询参数。

curl 'https://www.dockdart.com/api/v1/product?lang=zh'

GET /api/v1/product

产品信息

查询产品说明、适合人群、功能、macOS 要求、免费与 Pro 价格、下载链接和支持渠道。capabilities 描述的是 Mac App 的本机能力,不表示这些功能能够通过 API 远程调用。原有 ?mode=agent 产品摘要继续可用,新接入请使用下面的 v1 地址。

curl 'https://www.dockdart.com/api/v1/product?lang=zh'

GET /api/v1/release

最新版本与下载

获取当前正式版本、DMG 下载地址和 SHA-256 校验值。下面的示例直接读取正式发布配置;实际返回值会随新版本更新。此查询只读取元数据,下载文件需要再访问 downloadUrl。

curl 'https://www.dockdart.com/api/v1/release'
{
  "version": "1.0.0",
  "downloadUrl": "https://www.dockdart.com/download/DockDart-1.0.0.dmg",
  "sha256": "08bc7d205c7d2dda03390c082ad6ac03a7cb1fe4f2a8e8a7b7c8c590a6331811",
  "format": "DMG",
  "operatingSystem": "macOS 14 or later"
}

错误与恢复

所有 /api/ 下的错误均返回 application/problem+json,使用 RFC 9457 字段,并附上稳定的 code 和具体 resolution。400 表示查询参数无效;404 表示 API 路径不存在;405 表示方法不支持,此时 Allow 为 GET, HEAD。429 表示请求过多,请按 Retry-After 等待后重试。HEAD 错误不带正文,其他请求可读取下面的 JSON 结构。

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "The requested language is not supported.",
  "instance": "/api/v1/product?lang=fr",
  "code": "invalid_language",
  "resolution": "Set lang=en or lang=zh, or omit lang to use English."
}

限流规则

v1 查询按客户端 IP,在每个 Cloudflare 边缘位置使用每 60 秒 120 次请求的策略。边缘限流是近似保护,不是全球精确计数。响应的 RateLimit-Policy 公布规则,X-RateLimit-Limit 提供兼容上限;达到限制时返回 429、Retry-After: 60 和剩余额度为 0 的 RateLimit。成功响应不虚构实时剩余次数。缓存命中可减少请求,请勿频繁轮询。

版本与退役政策

成功响应为 application/json,可缓存 300 秒;错误响应不缓存。/api/v1 是稳定的主版本路径,兼容的字段扩展可在 v1 内发布;破坏兼容的变化会使用新的主版本。v1 当前没有弃用或下线计划。今后移除任何稳定版本前,至少提前 90 天在本页发布迁移指南,并通过 RFC 9745 Deprecation 和 RFC 8594 Sunset 响应头通知退役日期;当前正常使用的版本不发送虚假的弃用时间。两个查询都返回单个对象,不需要分页、幂等键或异步任务。接口不提供写入、订阅和 Webhook。

规范与帮助

接入问题请联系 support@dockdart.com,并附请求地址、状态码和错误码;不要发送账户密码或许可证。

support@dockdart.com