Rowcert
Kostenlos starten

API

KI-Sachbearbeiter mit Ihren Systemen verbinden

Senden Sie Dokumente aus ERP, Mail-Robotern oder Scannern und erhalten Sie dieselben geprüften Zeilen wie im Konto. Ergebnisse kommen auf Wunsch per signiertem Webhook.

https://rowcert.com/api/v1

1.Authentifizierung

Erstellen Sie unter Einstellungen → API und Webhooks einen Token und senden Sie ihn als Bearer-Token. Die KI-Sachbearbeiter Ihrer Firma:

curl https://rowcert.com/api/v1/workflows \
  -H "Authorization: Bearer ack_your_token"

2.Dokumente verarbeiten

Senden Sie eine oder mehrere Dateien mit der Kennung des Sachbearbeiters (Slug eines fertigen oder ID eines eigenen). Die Antwort kommt, sobald die Tabelle fertig ist – meist in Sekunden.

curl https://rowcert.com/api/v1/runs \
  -H "Authorization: Bearer ack_your_token" \
  -F workflow=accounting-invoice-line-item-extractor \
  -F files=@invoice-0412.pdf

# 200 OK
{
  "id": "6f1c…",
  "status": "completed",
  "pages": 1,
  "summary": { "vendor_name": "Northwind Office Supplies", "total_gross_amount": 649.76 },
  "rows": [ { "sku_or_code": "A-221", "quantity": 10, "unit_price": 24, "line_total_net": 240 } ]
}

3.Verarbeitung abrufen

Jede Verarbeitung bleibt im Archiv. Rufen Sie sie jederzeit ab, inklusive Korrekturen Ihres Teams.

curl https://rowcert.com/api/v1/runs/6f1c… \
  -H "Authorization: Bearer ack_your_token"

4.Ergebnisse per Webhook

Hinterlegen Sie eine https-URL in den Einstellungen. Nach jeder Verarbeitung – im Konto oder per API – senden wir das signierte Ergebnis. Prüfen Sie die Signatur, bevor Sie den Daten vertrauen:

// POST to your URL after every completed run
// Header: X-Rowcert-Signature: sha256=<hex>
import { createHmac, timingSafeEqual } from "node:crypto";

function verify(rawBody: string, header: string, secret: string) {
  const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex");
  return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}

// Body: { "event": "run.completed", "id": "…", "workflow": "…", "files": [...], "pages": 1, "summary": {...}, "rows": [...] }

Grenzen

  • Bis 10 Dateien und 4 MB pro API-Aufruf, bis 60 Seiten.
  • PDF, JPG, PNG, WEBP und CSV.
  • Seiten werden wie im Konto berechnet: eigener KI-Schlüssel oder Plattform-Credits.
  • Originale werden nach 24 Stunden gelöscht; die Daten bleiben im Archiv.
  • Bis 30 Verarbeitungen pro Minute und Firma (darüber HTTP 429 mit Retry-After).