Skip to content

LaventeCare Developer Portal

Technical Hub voor integratie met de LaventeCare Core.

Integration Guide

Verbind uw Astro applicatie met onze beveiligde backend.

Installation
npm install @laventecare/sdk
npx laventecare init

IoT Telemetry Guide

HMAC Authentication

Hardware devices gebruiken HMAC-SHA256 signatures in plaats van JWTs. Dit voorkomt replay attacks en garandeert data-integriteit.

Payload Structure:

{
  "device_id": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1706555555,
  "metrics": {
    "temperature": 22.5,
    "humidity": 45.2
  },
  "signature": "hmac_sha256_hash_here"
}

Authentication (Anti-Gravity Law #2)

Onze API gebruikt JWT (JSON Web Tokens) in `HttpOnly` cookies voor sessiebeheer. Client-side access tokens zijn kortlevend.

Security Headers: Elke request moet een geldig `X-CSRF-Token` bevatten.

Public Endpoints

GET /v1/health

Liveness & DB connectivity check.

POST /v1/auth/login

Credential validation. Returns HttpOnly cookies.

POST /v1/iot/telemetry

Ingest IoT data points (Rate Limit: 1000 req/min).