API
Połącz asystentów AI z własnymi systemami
Wysyłaj dokumenty z ERP, robota pocztowego lub skanera i otrzymuj te same sprawdzone wiersze co na koncie, także przez podpisany webhook.
https://rowcert.com/api/v1
1.Uwierzytelnianie
Utwórz token w Ustawieniach → API i webhooki i wysyłaj go jako Bearer token. Lista asystentów AI Twojej firmy:
curl https://rowcert.com/api/v1/workflows \
-H "Authorization: Bearer ack_your_token"2.Przetwarzanie dokumentów
Wyślij jeden lub więcej plików z identyfikatorem asystenta (slug gotowego lub id własnego). Odpowiedź przychodzi, gdy tabela jest gotowa, zwykle w kilka sekund.
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.Odczyt przetworzenia
Każde przetworzenie zostaje w archiwum. Odczytaj je w dowolnej chwili, razem z poprawkami zespołu.
curl https://rowcert.com/api/v1/runs/6f1c… \
-H "Authorization: Bearer ack_your_token"4.Wyniki przez webhook
Ustaw adres https w Ustawieniach. Po każdym przetworzeniu, z konta lub przez API, wysyłamy podpisany wynik. Sprawdź podpis, zanim zaufasz danym:
// 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": [...] }Limity
- Do 10 plików i 4 MB na wywołanie API, do 60 stron.
- PDF, JPG, PNG, WEBP i CSV.
- Strony rozliczane jak na koncie: własny klucz AI lub kredyty.
- Oryginały są usuwane po 24 godzinach; dane zostają w archiwum.
- Do 30 przetworzeń na minutę na firmę (powyżej HTTP 429 z Retry-After).