Dla deweloperów

Buduj w oparciu o zapis. Weryfikuj go z poziomu własnych systemów.

Wszystko, co ludzie robią w HONESTAS, Państwa systemy mogą wykonać przez API – z tymi samymi uprawnieniami, barierami i zapisami. Mogą Państwo odczytywać i weryfikować opieczętowane zapisy, odbierać zdarzenia na bieżąco, łączyć agentów swoich partnerów oraz umieścić ścieżkę kwotowania na własnej stronie.

Uzyskaj dostęp do piaskownicy Format zapisu

Jeden otwarty format zapisuPodpisane webhookiPołączenia agent-agent

honestas · api · verify a passportDane przykładowe

POST ‹the verify endpoint›
Content-Type: application/json

{ "file": "2026-1020-7741.json" }

// 200 OK
{
  "verdict": "holds",
  "records": [
    { "id": "2026-1009-7741", "seal": "matches" },
    { "id": "2026-1015-7741", "seal": "matches" }
  ],
  "timestamp": "checks",
  "countersigned": "2 of 2",
  "newer_versions": ["starting-table"]
}

Zweryfikuj paszport. Dwa zapisy są nienaruszone, zewnętrzny znacznik czasu się zgadza, a jedna z użytych tabel ma nowszą wersję.Dane przykładowe

Format zapisu

Jeden zapis, w otwartym formacie, który można odczytać.

Każda opieczętowana decyzja to jeden dokument JSON, a Paszport Decyzji to plik zawierający takie dokumenty. Format jest publicznie dostępny, dzięki czemu Państwa systemy, audytor i partnerzy odczytują dokładnie to samo co my.

Kto podjął decyzję, w ramach jakiego pełnomocnictwa i w jakiej wersji
Każdy dowód z własnym odciskiem cyfrowym
Tabele i warunki ubezpieczenia (OWU), do których decyzja została przypięta
Pieczęć, zewnętrzny znacznik czasu i kontrasygnaty

{
  "record": "2026-1015-7741",
  "kind": "claim.settlement",
  "owner": { "firm": "northgate", "unit": "claims" },
  "decision": { "outcome": "settle", "amount": 930000, "currency": "GBP" },
  "signed_by": "sara.lindqvist",
  "authority": { "instrument": "CA-ASH-01", "version": 2 },
  "checks": { "second_model": "agree", "passed": 27 },
  "evidence": [
    { "item": "roof-photographs", "fingerprint": "sha256:7c1e04a9…" }
  ],
  "pins": [{ "table": "starting-table", "version": 3 }],
  "seal": { "fingerprint": "sha256:f0f668bf…", "countersigned": 2 }
}

Opieczętowany zapis szkody, w skrócie

Zweryfikuj zapis

Sprawdź zapis bez pytania nas.

Wyślij plik do punktu końcowego weryfikacji lub uruchom opublikowaną bibliotekę weryfikującą na własnych maszynach, bez żadnego wywołania do HONESTAS. Obie metody zwracają te same trzy werdykty. Dostęp do piaskownicy obejmuje dokładne adresy oraz bibliotekę dla Państwa języka programowania.

holds
Każdy odcisk cyfrowy zgadza się z pieczęcią, znacznik czasu jest prawidłowy, a kontrasygnaty są obecne.
changed
Coś w pliku różni się od tego, co zostało opieczętowane. Odpowiedź wskazuje zapis i zmodyfikowany fragment wraz z kodem HASH_MISMATCH.
integralny, nowsza wersja
Rekord jest nienaruszony, natomiast tabela lub warunki (wording), do których był przypięty, zostały od tego czasu zastąpione nowszą wersją.

// opublikowana biblioteka weryfikatora, zainstalowana na własnej maszynie
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);

// nic nie jest nigdzie wysyłane
console.log(result.verdict);   // "holds"

Biblioteka weryfikatora, offline

API zdarzeń

Wszystko, co się dzieje, po kolei, od miejsca, w którym przerwano.

Odczytuj zdarzenia po kolei od ostatniej pozycji, filtrowane według typu. Każde zdarzenie zawiera odniesienie do rekordu, do którego należy, dzięki czemu Twoje systemy mogą pobrać pełny rekord, gdy go potrzebują.

record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over

GET ‹endpoint zdarzeń›
    after: evt_8841
    types: record.sealed, refusal.recorded

// 200 OK
{
  "events": [
    { "id": "evt_8842", "type": "refusal.recorded",
      "code": "GATE_DISAGREEMENT", "case": "CLM-2026-5120" },
    { "id": "evt_8843", "type": "record.sealed",
      "record": "2026-1015-7741" }
  ],
  "next": "evt_8843"
}

Webhooki

Twoje systemy dowiadują się o tym w chwili zapieczętowania rekordu.

Wybierz zdarzenia dla każdego endpointu. Każda wiadomość jest podpisana, dzięki czemu Twoje systemy mogą jej zaufać, a nieudane dostarczenie jest ponawiane i wyjaśniane na stronie danego endpointu.

Podpisane kluczem tajnym, który posiada tylko Twój endpoint
Ponawiane w kolejności, dopóki Twój endpoint nie odpowie
Każda dostawa pokazuje, co wysłano i co wróciło w odpowiedzi

const sig = req.headers[SIGNATURE_HEADER];   // wskazane na stronie endpointu
const ok = checkHmac(rawBody, sig, ENDPOINT_SECRET);
if (!ok) return res.status(401).end();

const event = JSON.parse(rawBody);
if (event.type === "record.sealed") {
  await claims.attachRecord(event.record);   // Twój własny system
}

Najpierw sprawdź podpis

Agent-to-agent

Agenci Twoich partnerów rozmawiają z Twoimi na podstawie pisemnej umowy.

Brokerzy, coverholderzy i reasekuratorzy łączą swoich agentów AI z Twoimi za pomocą otwartego protokołu Agent2Agent. Każde połączenie wskazuje umowę, na podstawie której działa, oraz to, o co każda ze stron może pytać.

Każde żądanie jest podpisane przez agenta, który je wysłał
Tylko uprawnienia dozwolone w umowie, nic więcej
Żądanie wykraczające poza umowę jest odrzucane i rejestrowane
Każda wymiana danych zapisywana w rejestrach obu firm

{
  "name": "Northgate Mutual · bordereaux",
  "url": "https://agents.northgate.example/bordereaux",
  "agreement": "CA-118",
  "skills": [
    { "id": "bordereau.submit" },
    { "id": "claim.status" }
  ],
  "auth": "podpisane żądanie, jeden klucz na partnera"
}

Karta agenta, publikowana dla każdego partnera

SDK dla strony

Ścieżka kwotowania na Twojej stronie, z wbudowanymi obowiązkami informacyjnymi.

Pakiet SDK dla kanału sprzedaży pozwala osadzić ścieżki kwotowania, zakupu i zgłaszania szkód HONESTAS na własnej stronie internetowej brokera lub ubezpieczyciela oraz w ich aplikacjach iOS i Android. Marka jest Twoja. Dokumentów, które klient musi zobaczyć przed płatnością, nie da się pominąć.

// pakiet SDK dla strony WWW, załadowany na Twojej witrynie
const quote = storefront.mount("#quote", {
  brand: "tern-brokers",
  product: "home",
  language: "en-IE"
});

quote.on("bound", (policy) => {
  crm.note(policy.id, "Kupiono online");
});

Ścieżka kwotowania pod własną marką, w kilku linijkach kodu

Markowa ścieżka wyceny brokera na etapie przed płatnością, wraz z dokumentami polisy, z którymi klient musi się najpierw zapoznać — **Zanim zapłacisz.** Krok czwarty z pięciu na stronie własnej brokera: podsumowanie polisy, warunki ubezpieczenia (wording) i wyłączenia odpowiedzialności, a następnie cena z podatkiem oraz wyszczególniona opłata brokerska.Dane przykładowe

**Zanim zapłacisz.** Krok czwarty z pięciu na stronie własnej brokera: podsumowanie polisy, warunki ubezpieczenia (wording) i wyłączenia odpowiedzialności, a następnie cena z podatkiem oraz wyszczególniona opłata brokerska.Dane przykładowe

Piaskownica

Dostęp do środowiska sandbox zaczyna się od prezentacji.

Każdemu zespołowi udostępniamy środowisko testowe (sandbox) z przykładowymi szkodami, polisami i rekordami, aby można było wywołać każdy endpoint przed podłączeniem rzeczywistego systemu.

Umów prezentację

Powiedz nam, co chcesz podłączyć: system szkodowy, partnera, kanał sprzedaży czy narzędzia audytora.

Uzyskaj dostęp do sandboxa

Przykładowy ubezpieczyciel z własnymi szkodami, pokojami, odmowami i zapieczętowanymi rekordami oraz kluczami przypisanymi do pojedynczych zadań.

Buduj w oparciu o sandbox

To samo API, zdarzenia i webhooki co na produkcji, z przykładowymi danymi, na których możesz bezpiecznie eksperymentować.

Przejdź na środowisko własnej firmy

Nowe klucze dla Twojej firmy – w naszej chmurze w UE lub w Twoim centrum danych. Twój kod się nie zmienia.

Pytania

Dla programistów.

Czy istnieje jedno API do wszystkiego?

Tak. Każdy ekran w HONESTAS jest zbudowany na tym samym API, z którego korzystają Twoje systemy, z tymi samymi uprawnieniami, barierami dostępu i rekordami. HONESTAS działa na Adverant Nexus, naszej platformie orkiestracji AI, dlatego API jest identyczne w naszej chmurze w UE oraz w Twoim własnym centrum danych.

Jak działają klucze?

Każdy klucz należy do jednego skryptu lub systemu, może wykonywać tylko przypisane mu zadania, ma dostęp wyłącznie do wybranych jednostek i wygasa w określonym dniu. Każde wywołanie jest rejestrowane, a klucz można wymienić (rotować) bez przestojów.

Czy API może zapisywać dane w naszym systemie szkodowym?

HONESTAS odczytuje dane z Twoich systemów polisowych, szkodowych oraz modeli i nigdy ich nie zastępuje. Gdy decyzja wymaga zapisania zwrotnego, odbywa się to poprzez weryfikowany, rejestrowany krok – nigdy jako bezpośrednia aktualizacja.

Jak wyglądają odmowy przez API?

Zwracane są te same kody, które widzą użytkownicy, np. AUTHORITY_EXCEEDED lub SCOPE_REFUSED, wraz z jasnym uzasadnieniem i kolejnym krokiem. Zobacz, kiedy system odmawia.

Jakie języki programowania są obsługiwane?

API wykorzystuje czysty protokół HTTP i format JSON, więc działa w każdym języku. Pakiet SDK dla kanału sprzedaży jest dostępny na strony WWW, systemy iOS i Android, a biblioteka weryfikatora – dla najpopularniejszych języków serwerowych.

Dowiedz się więcej

Umów prezentację

Podłącz swój pierwszy system.

Wskaż system, który musi wiedzieć o zapieczętowaniu szkody. Skonfigurujemy środowisko testowe (sandbox) i wspólnie podłączymy pierwszy webhook.

Uzyskaj dostęp do piaskownicy Połącz swoje systemy