Rowcert
Начать бесплатно

API

Подключите ИИ-клерков к своим системам

Отправляйте документы из ERP, почтового робота или сканера и получайте те же проверенные строки, что и в кабинете. Результат можно получать и подписанным вебхуком.

https://rowcert.com/api/v1

1.Авторизация

Создайте токен в Настройках → API и вебхуки. Передавайте его как Bearer-токен. Список ИИ-клерков вашей компании:

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

2.Обработка документов

Отправьте один или несколько файлов и идентификатор клерка (slug готового клерка или id своего). Ответ приходит, когда таблица готова, обычно за секунды.

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.Получить обработку

Каждая обработка хранится в архиве. Её можно прочитать в любой момент, включая правки, которые команда сделала в таблице.

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

4.Результаты через вебхук

Укажите https-адрес в Настройках. После каждой обработки — из кабинета или через API — мы отправим результат с подписью. Проверяйте подпись, прежде чем доверять данным:

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

Ограничения

  • До 10 файлов и 4 МБ за один вызов API, до 60 страниц.
  • PDF, JPG, PNG, WEBP и CSV.
  • Страницы оплачиваются как в кабинете: своим ключом ИИ или кредитами платформы.
  • Оригиналы удаляются через 24 часа, извлечённые данные остаются в архиве.
  • До 30 обработок в минуту на компанию (сверх этого — HTTP 429 с Retry-After).