Skip to content

Desktop apps ​

Homegrown desktop clients use native JSON: POST /api/v1/projects/{project_ref}/update/check. Store updaters (electron-updater, Sparkle, Tauri updater) use listing URLs on their own pages.

Package shape ​

ShapeMatrix package_typeIncremental
Single exe / dmg / AppImageSingle fileMay declare binary_delta and POST /update/diff. Algorithms: Incremental
Multi-file directoryMulti-fileGET integrity, then POST /update/pack. No per-dll binary delta. Oversized packs return 200 full_package

Console: Platform matrix, Release.

Client duties ​

  • Method must be POST. GET check is not this product’s query.
  • Verify SHA-256 after downloading package_url. Unknown delta magic falls back to the full package.
  • Optional POST .../telemetry/report (202); failures must not block install.

Related: Update check, Electron, Sparkle, Tauri.