mailorga - API

API / Anbinden

Ihre Daten per JSON-API abrufen - Konto cafe-lindenhof.example, nur Ihre Daten.

GET /api/v1/cafe-lindenhof.example/records · Belege-Liste (extrahierte Datensätze)
GET /api/v1/cafe-lindenhof.example/records/<id> · Rohdatei zu einem Datensatz

E-Mails/Vorgänge sind bewusst nur in der Konsole sichtbar, nicht über die Token-API (Mandanten-Isolation). Die API liefert die extrahierten Datensätze - genau das, was ein eigener KI-Agent zum Weiterarbeiten braucht.

Zugangs-Token

In der Live-Konsole erzeugen Sie hier mit einem Klick einen read-only Token (nur Ihre Daten, wird genau einmal angezeigt). In dieser Demo-Ansicht ist die Token-Verwaltung deaktiviert.

Beispiel

curl -H "Authorization: Bearer <ihr-token>" \
  https://mailorga.com/api/v1/cafe-lindenhof.example/records

Token nur im Authorization-Header senden, nie in der URL. Nur über HTTPS.

Beispiel-Antwort /records (extrahierte Datensätze)

{
  "mandant": "cafe-lindenhof.de",
  "records": [
    {
      "record_id": "v1__0",
      "typ": "rechnung",
      "format": "xml",
      "ts": "2026-06-09T10:00:00+00:00",
      "confidence": 0.92,
      "partei": "Muster GmbH",
      "download_url": "/api/v1/cafe-lindenhof.de/records/v1__0"
    }
  ]
}

Felder

records: aus Dokumenten extrahierte Datensätze (typ/format z.B. rechnung/xml, partei = Beleg-Gegenseite, confidence, download_url für die Rohdatei).

Handbuch: Daten per API abrufen
Über diese read-only JSON-API holen Sie Ihre eigenen Daten ab, etwa um sie in ein anderes Programm einzulesen. Die API liefert ausschließlich die Daten Ihres Kontos, nur lesend, nie die eines anderen Kunden. In vier Schritten: 1. Den Weg öffnen. Über den Reiter "API" in der Navigation öffnen Sie diese Ansicht. 2. Was es gibt. Ein Endpunkt mit Ihrem Konto-Schlüssel: GET /api/v1/<ihr-konto>/records die Belege (aus Dokumenten extrahierte Daten, z.B. Rechnungen) 3. Token erzeugen. "API-Token erzeugen" zeigt den Token genau einmal an, zusammen mit einem fertigen curl-Befehl, in den Ihr Konto und Ihr Token schon eingesetzt sind. Kopieren Sie den Token sofort und bewahren Sie ihn sicher auf. Ein neuer Token macht den alten ungültig (so können Sie ihn jederzeit tauschen). 4. Abrufen. Den Token im Authorization-Header mitgeben: curl -H "Authorization: Bearer <ihr-token>" https://mailorga.com/api/v1/<ihr-konto>/records Wichtig zur Sicherheit: - Der Token wird nur ein einziges Mal angezeigt. Gespeichert wird er bei uns nur als Prüfsumme, nicht im Klartext. Verloren oder unsicher geworden? Einfach einen neuen erzeugen, der alte wird damit ungültig. - Den Token nur im Authorization-Header senden, nie in der Adresse (URL). In der URL würde er in Server-Protokollen landen. - Nur über HTTPS abrufen. - Der Token ist read-only und zeigt nur Ihre eigenen Daten. - Nicht mehr gebraucht? "Token widerrufen" macht ihn sofort ungültig.