Developer API

Integrate Sensory directly into your build pipelines, CLI tools, and applications. Our API is designed for speed, isolation, and zero-trust asset mirroring.

Generate API Key

One-time generation

An API key enables File Isolation. Any file uploaded with this key is hidden from the public grid and only accessible when the same key is provided during download.

Sensory does not store your plaintext keys. Keep this safe.

Quick Start

Upload files directly from your terminal using cURL. Include the x-api-key header to isolate your mirror in a private namespace.

Bash / cURL

curl -X POST https://mirror.sdad.pro/api/upload \
  -H "x-api-key: your-api-key" \
  -F "file=@asset.png" \
  -F "ttl=7d"

CDN & Delivery Profiles

Sensory processes every request through our high-speed edge grid. Choose the profile that matches your application's visibility needs.

Standard Public

Globally cacheable, unauthenticated delivery. 1-year browser/edge TTL.

/[slug]

Requires: None

Isolated Namespace

API uploads stay off the public grid and are owned by your key. Delivery stays hotlinkable, so <img> and <video> just work.

/[slug]

Requires: None to read

Signed Private

Max security. HMAC token bound to the filename and an expiry — works in a plain <img> tag.

/[slug]?token=...

Requires: Signed token

Core Endpoints

POST/api/upload

Standard file upload. Supports multi-part form data.

Parameters (form-data)

file(File)— The asset to mirror (binary)

ttl(String)— 1h, 24h, 7d, or permanent

access(String)— public (default) or private

Headers

x-api-key— Optional. Your secure key for isolation.

GET/[slug]

Download a mirrored asset. Cacheable and hotlinkable — no headers needed. Supports Range requests, ETag/304 and CORS.

Headers

x-api-key— Optional. Verified if sent; not required to read.

Range— Optional. Byte range for streaming/resumable downloads.