FOR DEVELOPERS

Build your terrarium hardware. Plug it into Phasmida Cloud.

WHY THIS EXISTS

We connect bioactive measurement with real software.

Phasmida is built for people who want more than a closed gadget. Run your own hardware, send data to our cloud, observe everything in the dashboard, and keep API-level control for your own tooling.

Bioactive + IT in one platform

Readings from your terrarium become cloud data you can inspect in our dashboard and process in your own software.

Bring Your Own Hardware

Build your own ESP32-based setup, request a key, and connect to Phasmida Cloud — no waiting for a closed ecosystem.

API key model with device protection

Each key identifies one physical device and uses MAC binding to reduce key sharing and cloning risks.

Developer-first beta

The API is in beta and evolving fast. Reliable auth core now, telemetry and claim flows next.

HOW IT WORKS

Simple path from hardware to cloud.

Get your API key

Request a key for your setup. Free tier is available in beta — register and we issue the key manually.

Flash your firmware

Store the key in your device firmware and send it as a Bearer token on every HTTP request.

Bind on first request

On the first valid call the backend binds your reported MAC address to that key. Subsequent calls from a different MAC are rejected with 403.

Build your integration

Use the Smart Cloud dashboard for visibility and the API path for custom automations, tools, and workflows.

API KEY TYPES

Free beta key for BYOH. Bundled key for Phasmida hardware.

One key, one active device. You request a key once, flash it into your firmware, and every request is authenticated with it as a Bearer token. Need to move the key to a different device? Unbind it from the Smart Cloud dashboard — the key becomes re-bindable on the next request.

Free (beta)

BYOH — Bring Your Own Hardware

For makers, tinkerers, and developers who build their own ESP32-based setup and want to connect it to Phasmida Cloud.

1 device per key
Beta limitations apply
Manual key issuance
Full dashboard access
No telemetry endpoint yet (v1.2)

Get a Free key

Bundled

Phasmida hardware users

Every Phasmida-manufactured device ships with a pre-issued bundled key — flashed and ready on arrival.

Included in hardware price
Pre-flashed at factory
Automatic MAC binding
Full dashboard access
Roadmap features first

Browse hardware

BETA API TODAY

Device identity and security — live now.

v1 backend is production-shaped but still beta: stable enough to build against, intentionally narrow in scope, and expanding in documented iterations.

Code	Meaning
`200`	Key valid, MAC matches — request accepted
`401`	Missing or malformed Authorization header; key not found
`403`	Key revoked, or MAC mismatch (different device)

Telemetry endpoint and claim flow are next iterations. Start with the identity layer now, then evolve with us.

Request (beta)

POST /health
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "macaddress": "AA:BB:CC:DD:EE:FF",
  "firmware_version": "1.0.0",
  "ssid": "terrarium-lab"
}

First call — MAC binding

// mac_address is null → bound on first call
// bound_at timestamp set
// all future calls must match this MAC

Key exposed only once at issuance — store it immediately, it is not recoverable.

DEVICE LIFECYCLE

One key, one device — rebindable when you need it.

The MAC binding model ensures a single API key can only talk to one physical device at a time. If you replace a device or repurpose a key, you unbind via the Smart Cloud dashboard — no new key needed.

Issuedmac_address: null

→

ActiveMAC bound on first request

→

RevokedPermanent — all requests rejected

UnboundVia Smart Cloud dashboard — key re-bindable

↩ back to Active

Bind

Automatic on the first request. The MAC address reported by your firmware is stored and locked to this key.

Unbind

Available from the Smart Cloud dashboard. Clears the MAC binding — the next valid request will bind to the new device's MAC.

Revoke

Permanent disable. Use if a key is compromised or the device is decommissioned. Revocation cannot be undone — issue a new key instead.

ROADMAP

We tell you what is coming. No surprises.

The API grows in planned iterations. Build against v1 now — the auth model is stable and future endpoints follow the same key + MAC pattern.

v1 — nowLive

Device identity layer

API key issuance and management
MAC address binding (anti-cloning)
Bearer auth on all routes
Admin device lifecycle endpoints

v1.2

Telemetry ingest

POST /telemetry endpoint
Time-series sensor storage
last_seen_at tracking
Data visible in dashboard

v1.3

Device claim & user pairing

User registration and login
QR/token claim flow
Device linked to user account
Role-based admin access

EU infrastructure

Backend hosted in the EU. Your sensor data stays in Europe.

START BUILDING

Take a free key. Connect. Ship.

Free beta key available now. If you are building a serious deployment, talk to us.

Get API key (Free beta)Talk to us Explore Smart Cloud