Rowcert
Começar grátis

API

Ligue os assistentes IA aos seus sistemas

Envie documentos do seu ERP, robô de email ou digitalizador e receba as mesmas linhas verificadas da sua conta, também por webhook assinado.

https://rowcert.com/api/v1

1.Autenticação

Crie um token em Definições → API e webhooks e envie-o como Bearer token. Lista dos assistentes IA da sua empresa:

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

2.Processar documentos

Envie um ou mais ficheiros com o identificador do assistente (slug de um pronto ou id de um seu). A resposta chega quando a tabela está pronta, normalmente em segundos.

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.Ler um processamento

Cada processamento fica no seu arquivo. Leia-o quando quiser, com as correções da equipa.

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

4.Resultados por webhook

Defina um URL https nas Definições. Após cada processamento, na conta ou pela API, enviamos o resultado assinado. Verifique a assinatura antes de confiar nos dados:

// 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": [...] }

Limites

  • Até 10 ficheiros e 4 MB por chamada, até 60 páginas.
  • PDF, JPG, PNG, WEBP e CSV.
  • As páginas são cobradas como na conta: chave de IA própria ou créditos.
  • Os originais são apagados após 24 horas; os dados ficam no arquivo.
  • Até 30 processamentos por minuto por empresa (acima disso, HTTP 429 com Retry-After).