DockDart API Documentation

DockDart API. Read product information.

Public product facts, current releases, and official download links. Free, read-only, and no API key required.

Start querying

The DockDart API helps AI assistants, scripts, and websites explain the product, compare its features, and retrieve official download information. It only returns public product facts. It cannot read user files, control a Mac, activate a license, or make a purchase. Browser tabs, files, and system actions remain local features operated by the app user.

Authentication, pricing, and access

The API is public, free, and read-only. No account, API key, or OAuth is required. Send an HTTPS GET request; HEAD returns the same status and headers without a body. Browser clients may use cross-origin requests without cookies or credentials. Product information accepts lang=en or lang=zh and defaults to English. The release endpoint has no query parameters.

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

GET /api/v1/product

Product information

Read the description, audience, capabilities, macOS requirements, free and Pro pricing, download URL, and support channels. The capabilities field describes the native Mac app; those features are not remotely callable API operations. The existing ?mode=agent summary remains supported; use the versioned endpoint below for new integrations.

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

GET /api/v1/release

Latest release and download

Read the current app version, official DMG URL, and SHA-256 checksum. This example is generated from the real release configuration and changes when a release is published. The query only reads metadata; follow downloadUrl separately to download the app.

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"
}

Errors and recovery

Every error under /api/ returns application/problem+json with RFC 9457 fields, a stable code, and a concrete resolution hint. Status 400 means an invalid query parameter, 404 means an unknown API route, and 405 means an unsupported method with Allow: GET, HEAD. Status 429 means too many requests; wait for Retry-After before retrying. HEAD errors have no body; other requests can read the JSON structure below.

{
  "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."
}

Rate limits

The v1 endpoints use a policy of 120 requests per client IP in each 60-second window at each Cloudflare location. Edge enforcement is approximate, not a globally exact counter. RateLimit-Policy advertises the rule and X-RateLimit-Limit provides the compatibility quota. A limit hit returns 429, Retry-After: 60, and RateLimit with zero remaining quota. Successful responses do not invent a live remaining count. Reuse cached responses instead of polling frequently.

Versioning and deprecation policy

Successful application/json responses may be cached for 300 seconds; errors are not cached. /api/v1 is the stable major-version path. Compatible fields may be added within v1; breaking changes require a new major version. v1 is not deprecated and has no scheduled sunset. Before removing any stable version, DockDart will provide at least 90 days of notice and a migration guide on this page, and signal the deprecation date with RFC 9745 Deprecation and the retirement date with RFC 8594 Sunset response headers. Active versions do not advertise a fictional deprecation date. Both queries return a single object, so pagination, idempotency keys, and asynchronous jobs do not apply. Writes, subscriptions, and webhooks are not provided.

Specification and support

For integration help, email support@dockdart.com with the request URL, status, and error code. Do not send account passwords or license keys.

support@dockdart.com