API dla aplikacji (klucze tenantów)

Adres: https://weryfikacja.3perspective.com. Autoryzacja: nagłówek X-API-Key: <klucz> (albo Authorization: Bearer <klucz>). Klucze zakłada się w panelu (Klucze API); każdy klucz = osobny tenant (nazwa#id) — po usunięciu klucza i założeniu nowego o tej samej nazwie dane poprzedniego nie są widoczne. Odpowiedzi JSON po polsku; błąd = {"blad": "…"} ze statusem 400/401/404/429.

POST /v1/weryfikacja

Treść JSON: {"nip": "8943291245"} albo {"krs": "0001255925"}, "podpisujacy": ["Jan Kowalski", "Anna Nowak"] (1–2 osoby), "uzyj_ai": true. Wariant multipart (z wydrukiem KRS, pełne nazwiska): pola nip/krs, podpisujacy, podpisujacy2, plik wydruk_pdf.

curl -X POST https://weryfikacja.3perspective.com/v1/weryfikacja -H "X-API-Key: $KEY" -H "content-type: application/json" \
  -d '{"nip":"8943291245","podpisujacy":["Paulina Wysoczańska"]}'

Odpowiedź (201): id, rejestr (KRS | CEIDG | BRAK), podmiot (nazwa, krs, nip, regon, adres, kapital_zakladowy, status_vat, data_odpisu), status, reprezentacja (organ, sposob = cytat), osoby, dopasowania (stopien: pelne | maska | nazwisko | brak), interpretacja (reguły albo AI), werdykt {kod, opis, pewnosc, uzasadnienie, cytaty, wspolpodpis}, ostrzezenia, zastrzezenie, dowod {json, html, pdf}.

Kody werdyktu: MOZE_SAMODZIELNIE, MOGA_LACZNIE, TYLKO_LACZNIE, NIE_FIGURUJE, ZAWIESZONY, PODMIOT_NIEAKTYWNY, NIEJASNE. Pewność: wysoka | srednia (dane zamaskowane w API KRS albo interpretacja AI) | niska (samo nazwisko).

GET /v1/weryfikacje?limit=50 · GET /v1/weryfikacje/{id} · GET /v1/weryfikacje/{id}/dowod.json|html|pdf

Historia tenanta, pojedyncza weryfikacja, dowód (JSON = pełny wynik z surowymi odpowiedziami źródeł i SHA-256; PDF/HTML = czytelne podsumowanie z datą i godziną pobrania).

POST /v1/szablony (multipart: nazwa, plik .docx) · GET /v1/szablony · DELETE /v1/szablony/{id}

Wzory umów tenanta (DOCX ze znacznikami Jinja; odpowiedź zawiera wykryte pola).

POST /v1/umowa

{"weryfikacja_id": 12, "szablon_id": 3, "pola": {"numer_umowy": "12/2026"}, "wymus": false}

Generuje umowę z danymi podmiotu i reprezentantów (werdykt musi pozwalać na podpis, chyba że wymus: true). Odpowiedź: id, docx, pdf (null, gdy serwer nie ma konwertera), pola (co wstawiono). Pliki: GET /v1/umowy/{id}.docx|.pdf.

GET /v1/zuzycie

Liczba wywołań, weryfikacji i umów tenanta.

Limity i źródła

30 weryfikacji na minutę z jednego adresu IP. Źródła: Otwarte API KRS (odpis aktualny, rejestr P i S; dane osobowe zamaskowane przez MS), Wykaz podatników VAT MF (NIP → KRS/REGON/status VAT), CEIDG (gdy skonfigurowany token). Rejestr mówi, KTO MOŻE podpisać w imieniu podmiotu. Narzędzie nie potwierdza tożsamości osoby, która faktycznie podpisuje — tożsamość sprawdź osobno (dowód tożsamości, podpis kwalifikowany, Profil Zaufany / podpis zaufany).