Die API von Filarr ist offen: Ihre verschlüsselten Datenbanken für Ihre Software

Eine Filarr-Datenbank ist Ende-zu-Ende verschlüsselt: Unsere Server bewahren Blöcke auf, die sie nicht lesen können. Genau das schützt sie, und bisher hat genau das sie auch daran gehindert, mit Ihrer übrigen Software zu sprechen. Ein ERP, ein Dashboard, eine Website oder ein KI-Assistent kann keine verschlüsselten Blöcke lesen.

Seit dem 27. Oktober 2026 steht die API von Filarr jedem Konto offen. Eine Datenbank öffnen Sie über ihr Menü für eine API, und Filarr Gate, eine Blackbox, die Sie selbst betreiben, entschlüsselt sie und stellt sie Ihrer Software bereit. Mit einer Blackbox bei Ihnen sehen die Server von Filarr weiterhin nur verschlüsselte Blöcke.

Dieser Artikel zeigt den gesamten Weg, von der Datenbank in Filarr bis zur ersten Anfrage, mit Screenshots von Filarr Gate 0.3.1. Er sagt auch, was die Blackbox nicht leistet.

Warum eine Blackbox und kein gewöhnlicher API-Schlüssel

Bei den meisten Diensten funktioniert eine API so: Der Server liest Ihre Daten im Klartext und gibt sie an jeden heraus, der den richtigen Schlüssel vorzeigt. Bei Filarr ist das von der Bauart her unmöglich, denn der Server besitzt den Schlüssel zu Ihren Datenbanken nicht, es sei denn, Sie vertrauen ihn ihm an (siehe die gehostete Box weiter unten).

Filarr Gate dreht das um. Es ist ein kleines Programm, das Sie installieren, wo immer Sie möchten:

auf Ihrem Computer (npx filarr-gate);
auf einem Firmenserver, als Docker-Image (ghcr.io/filarr-work/gate);
in Ihrem eigenen Cloudflare-Konto;
oder direkt in Ihrem Code (npm install @filarr/gate).

Es lädt die verschlüsselten Blöcke der Datenbanken herunter, die Sie dafür öffnen, entschlüsselt sie mit Schlüsseln, die aus seinem Token abgeleitet werden, hält die Kopie im Arbeitsspeicher und beantwortet die Anfragen Ihrer Software aus dieser Kopie.

Filarr ──(encrypted blocks)──▶ Filarr servers ──(encrypted blocks)──▶ Filarr Gate ──(JSON)──▶ ERP, site, BI, AI
                                 lesen nichts                          bei Ihnen

Sein Code ist öffentlich, unter der Lizenz Apache 2.0: github.com/filarr-work/filarr-gate.

Schritt 1: eine Datenbank in Filarr öffnen

Klicken Sie in einer Datenbank auf ··· und dann auf Open to an API… („Für eine API öffnen…“). Das Formular fragt nach:

einem Namen für den Zugang („ERP Werkstatt“, „Website“);
den geöffneten Datenbanken, jede mit Read („Lesen“) oder Read and write („Lesen und Schreiben“);
den Slugs, also dem Namen jeder Datenbank und jeder Ansicht in der API (clients, active-clients).

Slugs werden ein für alle Mal festgelegt. Wenn Sie die Datenbank oder eine Ansicht später umbenennen, bricht keine Integration.

Das Menü „···“ einer Datenbank in Filarr, mit „Open to an API…“

Filarr zeigt dann ein Token an, ein einziges Mal. Filarr behält nur einen Fingerabdruck davon: Geht es verloren, kann es ersetzt, aber nicht wiederhergestellt werden. Wer es besitzt, liest die Datenbanken, die es öffnet; behandeln Sie es also wie ein Passwort.

Das API-Token, nur einmal angezeigt, mit den vier Wegen, Filarr Gate zu installieren

Schritt 2: die Blackbox starten

Auf einem Computer genügen zwei Befehle:

npx filarr-gate init --token flr_live_…
npx filarr-gate

Die Verwaltungsoberfläche öffnet sich unter http://127.0.0.1:8787/admin/, auf Englisch oder Französisch. Das Dashboard zeigt die Verbindung zu Filarr, die replizierten Datenbanken, die beantworteten Anfragen und was Filarr in diesem Monat zählt.

Das Dashboard von Filarr Gate: drei replizierte Datenbanken, 45 aus dem Arbeitsspeicher beantwortete Anfragen, ein von Filarr bestätigter Schreibvorgang

Die Screenshots in diesem Artikel stammen von Filarr Gate 0.3.1, verbunden mit dem Demo-Server, der in seinem Repository mitgeliefert wird: Die Kunden und Bestellungen sind erfunden.

Schritt 3: Endpunkte, die aus Ihren Ansichten entstehen

Jede Datenbank wird zu GET /v1/<database>, jede Ansicht zu GET /v1/<database>/<view>. Die Ansicht „Aktive Kunden“ behält ihren Filter, ihre Sortierung und ihre Spalten: Die Ansicht ist der Vertrag, und Filarr Gate spielt sie mit Filarrs eigener Ansichts-Engine nach. Eine zum Schreiben geöffnete Datenbank akzeptiert außerdem POST, PATCH und DELETE.

Die Endpunkte der Datenbank Kunden: die ganze Datenbank zum Lesen und Schreiben und drei Ansichten zum Lesen

Ein Schreibvorgang wird zu einer verschlüsselten Änderung, die Filarr wie die eines beliebigen Geräts bestätigt und die sofort in der App sichtbar ist:

curl -X POST "http://127.0.0.1:8443/v1/commandes" \
  -H "Authorization: Bearer gk_…" \
  -H "Idempotency-Key: order-1042" \
  -d '{"numero": "CMD-1042", "montant": 180}'

Schritt 4: ein Schlüssel pro Software

Ihre Software erhält nie das Filarr-Token. Jede bekommt von der Blackbox ihren eigenen App-Schlüssel („app key“, gk_…), beschränkt auf die Endpunkte, die sie braucht. Jeder Schlüssel hat:

seine Rechte, Endpunkt für Endpunkt: lesen, hinzufügen, ändern, löschen;
eine maximale Anfragerate, erlaubte Adressen und ein Ablaufdatum.

Die Website liest den Katalog und fügt Bestellungen hinzu, sonst nichts. Wird ihr Schlüssel widerrufen, betrifft das keine andere Software.

Einen App-Schlüssel erstellen: Die Website liest den Katalog und die aktiven Kunden und fügt Bestellungen hinzu

Schritt 5: SQL, Webhooks und MCP für KI-Assistenten

Der SQL-Explorer führt ein SELECT mit der SQL-Engine von Filarr auf der entschlüsselten Kopie aus, einschließlich Joins und Gruppierungen. Eine nützliche Abfrage lässt sich als Endpunkt speichern (GET /v1/q/<name>).

Der SQL-Explorer: Umsatz nach Stadt, mit einem Join von Bestellungen und Kunden, in 0,4 ms

Dazu kommen:

signierte Webhooks (HMAC-SHA256) für jede hinzugefügte, geänderte oder gelöschte Zeile;
eine OpenAPI-3.1-Beschreibung, die aus den Spaltentypen erzeugt wird;
ein MCP-Server mit reinem Lesezugriff, damit ein KI-Assistent Ihre Datenbanken abfragen kann. Was der Assistent liest, erhält er im Klartext: Wählen Sie ihn so aus, wie Sie jeden Empfänger dieser Daten auswählen würden.

Schritt 6: Alles wird protokolliert, bei Ihnen

Jede beantwortete Anfrage und jeder Austausch mit Filarr landet im Protokoll der Blackbox. Es wird 30 Tage lang auf dem Rechner aufbewahrt und nirgendwohin gesendet. Es zeigt, wer was gelesen hat, die Ablehnungen (hier ein unbekannter Schlüssel) und die von Filarr empfangenen Synchronisierungen.

Das Protokoll von Filarr Gate: Lesezugriffe der Website, ein abgelehnter unbekannter Schlüssel, eine von Filarr empfangene Synchronisierung

Auf der Seite von Filarr listet Settings › API access („Einstellungen › API-Zugriff“) Ihre Zugänge auf, ihre Nutzung und den letzten Kontakt jeder Blackbox. Dort können Sie einen Zugang pausieren, sein Token ersetzen oder ihn widerrufen.

Settings › API access: der Zugang „ERP Atelier“, seine Blackbox, sein Verbrauch und die Schaltflächen zum Pausieren, Ersetzen des Tokens und Widerrufen

Eine Datenbank aus einer externen Datenbank speisen (ab Solo)

Eine Filarr-Datenbank lässt sich auch aus einer anderen Datenbank speisen oder in diese veröffentlichen: PostgreSQL, MySQL, Supabase, Cloudflare D1, Airtable, Google Sheets, Notion oder eine veröffentlichte CSV- oder JSON-Datei. Die Synchronisierung wird in Filarr festgelegt („···“ › Feed from an external database…, „Aus einer externen Datenbank speisen…“), in die eine Richtung, in die andere oder in beide.

Sie wird von einem Ihrer Geräte ausgeführt oder von Ihrer Blackbox. In diesem Fall werden die Schlüssel der externen Datenbank der Blackbox übergeben und laufen nie über Filarr. Eine PostgreSQL-Datenbank lässt sich nur am Desktop einrichten. Im Web laufen Aufrufe an einen externen Dienst über ein Relais von Filarr, das nichts speichert; dieser Austausch ist nicht Ende-zu-Ende verschlüsselt.

Eine Datenbank aus einer externen Datenbank speisen: die Wahl des Connectors, hier PostgreSQL, am Desktop und für die Blackbox

Dateien über die API empfangen (ab Pro)

Ein App-Schlüssel kann Dateien ablegen (POST /v1/files). Sie werden für einen Ihrer Ablagekästen versiegelt, dann entschlüsselt die Filarr-App sie und ordnet sie nach Ihren Ablageregeln ein. Eine Rechnungssoftware kann so jede Rechnung im richtigen Ordner ablegen, ohne dass Filarr sie liest.

Über die API empfangene Dateien: zwei vom ERP abgelegte Dateien, einsortiert in „Factures & Devis“

Was jeder Tarif enthält

Lesezugriffe, die die Blackbox beantwortet, laufen nicht über Filarr: Sie werden weder gezählt noch gedrosselt. Nur der Austausch mit Filarr wird es.

	Free	Solo	Pro	Teams
API-Zugänge	1	3	20	100
Datenbanken pro Zugang	1	3	20	100
Schreibvorgänge Ihrer Software	nein	1.000 / Tag	20.000 / Tag	100.000 / Tag
Live-Änderungen	alle 5 Min. abgefragt	ja	ja	ja
Synchronisierung aus einer externen Datenbank	nein	ja	ja	ja
Über die API empfangene Dateien	nein	nein	2.000 / Monat	10.000 / Monat
Erlaubte Adressen	nein	nein	ja	ja
Von Filarr gehostete Box	nein	nein	Option, 4 € / Monat	1 inklusive

Das sind die Werte, die der Server von Filarr am 27. Oktober 2026 zurückgibt. Enterprise nutzt die Werte von Teams, und die Hilfe erklärt die Tarife im Detail.

Was die Blackbox nicht ist

Eine API über verschlüsselten Daten hat Grenzen. Besser, Sie kennen sie, bevor Sie irgendeine Software anschließen.

Wer die Blackbox betreibt, liest die Datenbanken. Sie besitzt den Schlüssel zu den Datenbanken, für die sie geöffnet wurde, und hält eine entschlüsselte Kopie im Arbeitsspeicher. Schützen Sie den Rechner so, wie Sie die Daten schützen würden.
Eine Ansicht ist keine Grenze. Die Blackbox liest die gesamte Datenbank, für die sie geöffnet ist, nicht nur das, was Ihre Ansichten zeigen. Um weniger zu teilen, öffnen Sie eine Datenbank, die weniger enthält.
Eine Blackbox ohne Verbindung behält ihre Kopie. Nach einem Widerruf behält eine Blackbox, die Filarr nicht mehr erreicht, was sie bereits kopiert hat, bis sie sich wieder verbindet oder jemand die Kopie auf ihrem Rechner löscht.
Filarr sieht Metadaten. Seine Server sehen verschlüsselte Blöcke, Zähler, die IP-Adresse und die Version der Blackbox. Sie sehen nie das Token, einen Datenbankschlüssel oder eine Zeile.
Die von Filarr gehostete Box ist die Ausnahme. Sie ist eine Option ab Pro, für 4 € im Monat oder 48 € im Jahr. Eine Teams- oder Enterprise-Organisation hat eine Box inklusive, die ihr die Person zuweist, die ihre Abrechnung verwaltet; vorerst im Web, der Desktop folgt mit seiner nächsten Version. Die Datenbanken, die Sie ihr anvertrauen, sind nicht mehr Ende-zu-Ende verschlüsselt: Ihr Schlüssel wird von unseren Servern verwaltet, die sie entschlüsseln, um die API zu bedienen. Vor ihrer Öffnung am 27. Oktober 2026 wurde eine interne Sicherheitsprüfung durchgeführt; die externe Prüfung ist geplant. Ihre Bedingungen stehen im Anhang zum AVV (auf Englisch) und im Trust Center.
Die Android-App folgt mit ihrer nächsten Version. Eine für eine API geöffnete Datenbank wechselt in den Speicher von Filarr für große Datenbanken. Die aktuelle Android-App unterstützt diesen noch nicht: Auf dem Telefon kann diese Datenbank bis zur nächsten Version schreibgeschützt bleiben.

Wo Sie anfangen

Aktualisieren Sie Filarr auf dem Desktop (3.10.0) oder öffnen Sie die Web-App.
Wählen Sie eine kleine Datenbank, etwa einen Katalog oder eine Kundenliste, und öffnen Sie sie zum Lesen für eine API.
Starten Sie npx filarr-gate und rufen Sie seine erste Ansicht auf.

Die Hilfe erklärt jeden Bildschirm im Detail: Eine Datenbank für eine API öffnen, Ihren API-Zugriff verwalten und Die Blackbox, dazu Eine Datenbank aus einer externen Datenbank speisen und Dateien über die API empfangen. Die Tutorials von Filarr Gate, mit Beispielen in curl, JavaScript und Python, finden Sie in seinem Repository.