Getting Started with Development

Fentrica provides integration capabilities for third-party applications that want to connect with our smart building infrastructure — including smart spaces, IoT devices, access control, and real-time device communication.

Integration Options

Integrate your product with Fentrica

If you want to integrate your product (e.g. access control system, hotel management software, property management software) with the Fentrica platform, please contact our support team to find the best and most secure integration path for your use case.

Integrate Fentrica smart spaces into your product

If you want to embed Fentrica smart spaces — real-time device controls, sensors, climate, lighting, doors, and more — into your own application, follow this guide.

Prerequisites

Before your application can connect to Fentrica smart spaces, the following must be in place:

1. Custom Authentication — Your application must implement JWKS-based authentication and user synchronization with the Fentrica platform. Contact support to set this up.
2. Service Connection — A service connection must be established between your application and the Fentrica platform. This grants your authenticated users access to assigned smart spaces and devices.
3. Fetch Units & Devices — Use the Service Connection API to retrieve the smart space units and devices your user has access to.
4. Connect to Devices — Establish real-time WebSocket connections to each device using the @larva.io/clouddevice library.
5. Render UI Components — Load and render device controls using @larva.io/webcomponents in your React, Vue, or vanilla JS application.

Service Connection API

Once authentication and service connection are configured, your application can fetch the units and devices assigned to the authenticated user.

Server

The API is available at:

https://api.building.fentrica.com/orgs

The /orgs path prefix identifies the Organizations microservice — all service connection endpoints are served from this microservice.

Endpoint

GET https://api.building.fentrica.com/orgs/orgs/:orgId/services/connections/:serviceConnectionExternalId/access-policies/:accessPolicyExternalId/views/units-devices

CORS Policy

The API is protected with CORS. During development, requests are allowed from:

• capacitor:// — Capacitor native app shell
• http://localhost:8080 — local development server

Any custom domain or cloud-hosted application must be whitelisted by our support team before it can make API requests. Contact support to register your origin.

Authentication

Requests must include a valid tenant JWT token issued through the JWKS authentication flow.

Path Parameters

Response

Returns an array of units with their associated devices:

[
  {
    "id": "unit-uuid",
    "name": "Apartment 301",
    "devices": [
      {
        "id": "device-uuid",
        "serialNumber": "FEN-A1B2C3"
      }
    ]
  },
  {
    "id": "unit-uuid-2",
    "name": "Apartment 302",
    "devices": [
      {
        "id": "device-uuid-2",
        "serialNumber": "FEN-D4E5F6"
      }
    ]
  }
]

Each unit represents a smart space, and each device is a Fentrica edge device (controller) that your application connects to for real-time control.

Next Steps

• Cloud Device Connection — Connect to devices via WebSocket
• Web Components — Render device controls in your app