Vývojári

Stavajte na zázname. Overujte ho z vlastných systémov.

Všetko, čo ľudia robia v systéme HONESTAS, dokážu vaše systémy robiť cez API – s rovnakými oprávneniami, bariérami a záznamami. Čítajte a overujte zapečatené záznamy, prijímajte udalosti v reálnom čase, prepájajte agentov vašich partnerov a vložte proces výpočtu poistného na vlastný web.

Získať prístup do sandboxu Formát záznamu

Jeden otvorený formát záznamuPodpísané webhookyPrepojenia medzi agentmi

honestas · api · overiť pasVzorové dáta

POST ‹koncový bod na overenie›
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"]
}

Overte pas. Dva záznamy platia, externá časová pečiatka sedí a jedna z použitých tabuliek má novšiu verziu.Vzorové dáta

Formát záznamu

Jeden záznam v otvorenom a čitateľnom formáte.

Každé zapečatené rozhodnutie je jeden dokument JSON a Decision Passport (Pas rozhodnutia) je súbor takýchto dokumentov. Formát je verejne publikovaný, takže vaše systémy, váš audítor aj vaši partneri čítajú presne to isté, čo my.

Kto rozhodol, na základe akej právomoci a v akej verzii
Každý dôkaz s vlastným digitálnym odtlačkom
Tabuľky a poistné podmienky, ku ktorým bolo rozhodnutie priradené
Pečať, externá časová pečiatka a spolupodpisy

{
  "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 }
}

Zapečatený záznam o poistnej udalosti, skrátený

Overenie záznamu

Skontrolujte záznam bez toho, aby ste sa nás pýtali.

Pošlite súbor na overovací koncový bod, alebo spustite publikovanú overovaciu knižnicu na vlastných serveroch úplne bez volania do systému HONESTAS. Oba spôsoby vrátia rovnaké tri verdikty. Prístup do sandboxu obsahuje presné adresy a knižnicu pre váš programovací jazyk.

holds
Každý digitálny odtlačok sa zhoduje so svojou pečaťou, časová pečiatka sedí a spolupodpisy sú prítomné.
changed
Niečo v súbore sa líši od toho, čo bolo zapečatené. Odpoveď uvedie konkrétny záznam a časť spolu s kódom HASH_MISMATCH.
platí, novšia verzia
Záznam je neporušený a tabuľka alebo poistné podmienky, na ktoré bol naviazaný, boli medzitým nahradené.

// zverejnená overovacia knižnica nainštalovaná na vašom vlastnom zariadení
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);

// nič sa nikam neodosiela
console.log(result.verdict);   // "platí"

Overovacia knižnica, offline

API udalostí

Všetko, čo sa stane, v poradí, presne od miesta, kde ste skončili.

Čítajte udalosti v poradí od poslednej pozície, filtrované podľa typu. Každá udalosť nesie záznam, ku ktorému patrí, takže vaše systémy si môžu vyžiadať celý záznam, keď ho potrebujú.

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

GET ‹koncový bod udalostí›
    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"
}

Webhooky

Vaše systémy sa to dozvedia v okamihu zapečatenia záznamu.

Vyberte udalosti pre každý koncový bod. Každé doručenie je podpísané, aby mu vaše systémy mohli dôverovať, a neúspešné doručenie sa zopakuje a vysvetlí priamo na stránke daného koncového bodu.

Podpísané tajným kľúčom, ktorý má len váš koncový bod
Opakované v poradí, kým váš koncový bod neodpovie
Každé doručenie zobrazuje, čo bolo odoslané a čo sa vrátilo

const sig = req.headers[SIGNATURE_HEADER];   // uvedené na stránke koncového bodu
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);   // váš vlastný systém
}

Najprv skontrolujte podpis

Agent-to-agent

Agenti vašich partnerov komunikujú s vašimi, na základe písomnej zmluvy.

Makléri, coverholderi a zaisťovne pripájajú svojich AI agentov k vašim cez otvorený protokol Agent2Agent. Každé prepojenie uvádza zmluvu, podľa ktorej funguje, a o čo môže každá strana požiadať.

Každá požiadavka je podpísaná agentom, ktorý ju odoslal
Iba oprávnenia povolené zmluvou, nič viac
Požiadavka mimo rámca zmluvy je odmietnutá a zaznamenaná
Každá výmena sa uchováva v záznamoch oboch spoločností

{
  "name": "Northgate Mutual · bordereaux",
  "url": "https://agents.northgate.example/bordereaux",
  "agreement": "CA-118",
  "skills": [
    { "id": "bordereau.submit" },
    { "id": "claim.status" }
  ],
  "auth": "podpísaná požiadavka, jeden kľúč na partnera"
}

Karta agenta zverejnená pre každého partnera

Storefront SDK

Cesta k cenovej ponuke na vašom webe, s pevne zabudovanými povinnými informáciami.

Storefront SDK vkladá procesy cenovej ponuky, dojednania poistenia a hlásenia škôd HONESTAS priamo na web makléra alebo poisťovne a do ich aplikácií pre iOS a Android. Značka je vaša. Dokumenty, ktoré musí klient vidieť pred zaplatením, sa nedajú preskočiť.

// storefront SDK pre web, načítané na vašej stránke
const quote = storefront.mount("#quote", {
  brand: "tern-brokers",
  product: "home",
  language: "en-IE"
});

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

Cesta k ponuke vo vašom dizajne, na pár riadkoch kódu

Značkový proces výpočtu poistného makléra v kroku pred platbou s poistnými dokumentmi, ktoré si zákazník musí najprv prečítať — **Pred zaplatením.** Štvrtý krok z piatich na vlastnej stránke makléra: súhrn poistenia, poistné podmienky a výluky, následne cena vrátane dane a zobrazená odmena makléra.Vzorové dáta

**Pred zaplatením.** Štvrtý krok z piatich na vlastnej stránke makléra: súhrn poistenia, poistné podmienky a výluky, následne cena vrátane dane a zobrazená odmena makléra.Vzorové dáta

Sandbox

Prístup do sandboxu začína ukážkou.

Každému tímu poskytneme sandboxovú spoločnosť plnú vzorových škôd, poistných zmlúv a záznamov, aby ste si mohli vyskúšať každý koncový bod pred pripojením reálneho systému.

Dohodnúť ukážku

Povedzte nám, čo chcete pripojiť: škodový systém, partnera, predajný portál alebo nástroje vášho audítora.

Získať sandbox

Vzorová poisťovňa s vlastnými škodami, priestormi, odmietnutiami a zapečatenými záznamami a kľúčmi, z ktorých každý plní jednu úlohu.

Vyvíjajte proti nemu

Rovnaké API, udalosti a webhooky ako v produkcii, so vzorovými dátami, ktoré môžete rozbiť.

Prejdite na vlastnú spoločnosť

Nové kľúče pre vašu spoločnosť, v našom cloude v EÚ alebo vo vašom dátovom centre. Váš kód sa nemení.

Otázky

Pre vývojárov.

Existuje jedno API na všetko?

Áno. Každá obrazovka v HONESTAS je postavená na rovnakom API, aké používajú vaše systémy, s rovnakými oprávneniami, bariérami a záznamami. HONESTAS beží na Adverant Nexus, našej platforme na orchestráciu AI, a preto je API rovnaké v našom cloude v EÚ aj vo vašom vlastnom dátovom centre.

Ako fungujú kľúče?

Každý kľúč patrí jednému skriptu alebo systému, môže vykonávať len úlohy, ktoré mu pridelíte, má dosah len na vami zvolené útvary a jeho platnosť končí k nastavenému dátumu. Každé jeho volanie sa zaznamenáva a kľúč je možné rotovať bez výpadku.

Môže API zapisovať do nášho škodového systému?

HONESTAS číta vaše systémy pre správu zmlúv, likvidáciu škôd a modely a nikdy ich nenahrádza. Keď je potrebné zapísať rozhodnutie späť, prebehne to cez kontrolovaný krok, ktorý sa zaznamená – nikdy nie priamou aktualizáciou.

Ako vyzerajú odmietnutia cez API?

Rovnaké kódy, aké vidia používatelia, napríklad AUTHORITY_EXCEEDED alebo SCOPE_REFUSED, s jasným dôvodom a ďalším krokom. Pozrite si, čo systém odmieta.

Ktoré programovacie jazyky sú podporované?

API využíva čisté HTTP a JSON, takže funguje s akýmkoľvek jazykom. Storefront SDK je k dispozícii pre web, iOS a Android a overovacia knižnica pre najbežnejšie serverové jazyky.

Zistiť viac

Dohodnúť ukážku

Pripojte svoj prvý systém.

Prineste systém, ktorý potrebuje vedieť, kedy je poistná udalosť zapečatená. Pripravíme vám sandbox a spolu s vami zapojíme prvý webhook.

Získať prístup do sandboxu Prepojte svoje systémy