API
Collegate gli assistenti IA ai vostri sistemi
Inviate documenti da ERP, robot email o scanner e ricevete le stesse righe verificate dell'account, anche tramite webhook firmato.
https://rowcert.com/api/v1
1.Autenticazione
Create un token in Impostazioni → API e webhook e inviatelo come Bearer token. Elenco degli assistenti IA della vostra azienda:
curl https://rowcert.com/api/v1/workflows \
-H "Authorization: Bearer ack_your_token"2.Elaborare documenti
Inviate uno o più file con l'identificativo dell'assistente (slug di uno pronto o id del vostro). La risposta arriva quando la tabella è pronta, di solito in pochi secondi.
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.Leggere un'elaborazione
Ogni elaborazione resta nell'archivio. Rileggetela quando volete, con le correzioni del team.
curl https://rowcert.com/api/v1/runs/6f1c… \
-H "Authorization: Bearer ack_your_token"4.Risultati via webhook
Impostate un URL https nelle Impostazioni. Dopo ogni elaborazione, dall'account o via API, inviamo il risultato firmato. Verificate la firma prima di fidarvi dei dati:
// 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": [...] }Limiti
- Fino a 10 file e 4 MB per chiamata, fino a 60 pagine.
- PDF, JPG, PNG, WEBP e CSV.
- Le pagine si pagano come nell'account: chiave IA propria o crediti.
- Gli originali vengono eliminati dopo 24 ore; i dati restano nell'archivio.
- Fino a 30 elaborazioni al minuto per azienda (oltre, HTTP 429 con Retry-After).