Za razvojne inženjere

Gradite na zapisu. Provjerite ga iz vlastitih sustava.

Sve što ljudi rade u sustavu HONESTAS, vaši sustavi mogu raditi putem API-ja, s istim ovlastima, barijerama i zapisima. Čitajte i provjeravajte zapečaćene zapise, primajte događaje u stvarnom vremenu, povežite agente svojih partnera i postavite izračun ponude na vlastitu mrežnu stranicu.

Zatražite pristup sandboxu Format zapisa

Jedan otvoreni format zapisaPotpisani webhookoviPoveznice između agenata

honestas · api · verify a passportOgledni podaci

POST ‹krajnja točka za provjeru›
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"]
}

Provjerite putovnicu odluke. Dva zapisa su valjana, vanjski vremenski žig je potvrđen, a jedna tablica koju su koristili ima noviju verziju.Ogledni podaci

Format zapisa

Jedan zapis, u otvorenom formatu koji možete čitati.

Svaka zapečaćena odluka jedan je JSON dokument, a Decision Passport je datoteka koja ih sadrži. Format je javno objavljen, tako da vaši sustavi, vaš revizor i vaši partneri čitaju isto što i mi.

Tko je donio odluku, prema kojem ovlaštenju i verziji
Svaki dokaz s vlastitim digitalnim otiskom
Tablice i uvjeti osiguranja za koje je odluka vezana
Pečat, vanjski vremenski žig i supotpisi

{
  "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čaćeni zapis o šteti, skraćeno

Provjerite zapis

Provjerite zapis bez da nas pitate.

Pošaljite datoteku na krajnju točku za provjeru ili pokrenite objavljenu biblioteku za provjeru na vlastitim poslužiteljima bez ikakvog poziva prema sustavu HONESTAS. Oba načina daju ista tri ishoda. Pristup sandboxu donosi točne adrese i biblioteku za vaš programski jezik.

holds
Svaki digitalni otisak odgovara svom pečatu, vremenski žig je ispravan i supotpisi su prisutni.
changed
Nešto u datoteci razlikuje se od onoga što je zapečaćeno. Odgovor navodi zapis i dio, uz oznaku HASH_MISMATCH.
vrijedi, novija verzija
Zapis je netaknut, a tablica ili uvjeti osiguranja na koje je bio vezan u međuvremenu su zamijenjeni.

// objavljena biblioteka za provjeru, instalirana na vašem računalu
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);

// ništa se nikamo ne šalje
console.log(result.verdict);   // "holds"

Biblioteka za provjeru, izvanmrežno

API za događaje

Sve što se dogodi, redom, od mjesta gdje ste stali.

Čitajte događaje redom od svoje posljednje pozicije, filtrirane prema vrsti. Svaki događaj nosi zapis kojem pripada, tako da vaši sustavi mogu dohvatiti cijeli zapis kada im zatreba.

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

GET ‹krajnja točka za događaje›
    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"
}

Webhookovi

Vaši sustavi to doznaju u trenutku kad se zapis zapečati.

Odaberite događaje za svaku krajnju točku. Svaka je isporuka potpisana kako bi joj vaši sustavi mogli vjerovati, a neuspjela isporuka ponovno se pokušava i objašnjava na samoj stranici krajnje točke.

Potpisano tajnim ključem koji ima samo vaša krajnja točka
Ponovni pokušaji, po redu, dok vaša krajnja točka ne odgovori
Svaka isporuka prikazuje što je poslano i što je vraćeno

const sig = req.headers[SIGNATURE_HEADER];   // navedeno na stranici krajnje točke
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);   // vaš vlastiti sustav
}

Prvo provjerite potpis

Između agenata

Agenti vaših partnera razgovaraju s vašima, prema pisanom ugovoru.

Brokeri, coverholderi i reosiguratelji povezuju svoje AI agente s vašima putem otvorenog protokola Agent2Agent. Svaka poveznica navodi ugovor prema kojem djeluje i što svaka strana smije zatražiti.

Svaki zahtjev potpisuje agent koji ga je poslao
Samo vještine koje ugovor dopušta, ništa drugo
Zahtjev izvan okvira ugovora odbija se i bilježi
Svaka razmjena čuva se u evidenciji obiju tvrtki

{
  "name": "Northgate Mutual · bordereaux",
  "url": "https://agents.northgate.example/bordereaux",
  "agreement": "CA-118",
  "skills": [
    { "id": "bordereau.submit" },
    { "id": "claim.status" }
  ],
  "auth": "potpisani zahtjev, jedan ključ po partneru"
}

Kartica agenta, objavljena za svakog partnera

Storefront SDK

Postupak izračuna ponude na vašoj stranici, s ugrađenim obveznim informacijama.

Prodajni SDK ugrađuje HONESTAS postupke izračuna ponude, kupnje i prijave štete na vlastitu web-stranicu brokera ili osiguratelja te u njihove iOS i Android aplikacije. Brend je vaš. Dokumenti koje ugovaratelj mora vidjeti prije plaćanja ne mogu se preskočiti.

// prodajni SDK za web, učitan na vašoj stranici
const quote = storefront.mount("#quote", {
  brand: "tern-brokers",
  product: "home",
  language: "en-IE"
});

quote.on("bound", (policy) => {
  crm.note(policy.id, "Kupljeno putem interneta");
});

Brendirani postupak izračuna ponude, u nekoliko redaka

Brendirani proces izračuna ponude brokera na koraku prije plaćanja, s dokumentima police koje klijent prvo mora pročitati — **Prije plaćanja.** Četvrti korak od pet na vlastitoj stranici brokera: sažetak police, uvjeti osiguranja i isključenja, a zatim prikaz cijene s porezom i brokerskom naknadom.Ogledni podaci

**Prije plaćanja.** Četvrti korak od pet na vlastitoj stranici brokera: sažetak police, uvjeti osiguranja i isključenja, a zatim prikaz cijene s porezom i brokerskom naknadom.Ogledni podaci

Sandbox

Pristup testnom okruženju počinje prezentacijom.

Svakom timu dajemo testnu tvrtku punu oglednih odštetnih zahtjeva, polica i zapisa, tako da možete pozvati svaku krajnju točku prije nego što povežete stvarni sustav.

Rezervirajte demo

Recite nam što želite povezati: sustav za obradu šteta, partnera, prodajno sučelje ili alate vašeg revizora.

Zatražite testno okruženje

Ogledni osiguratelj s vlastitim odštetnim zahtjevima, sobama, odbijanjima i zapečaćenim zapisima te ključevima od kojih svaki obavlja jedan zadatak.

Razvijajte na temelju toga

Isti API, događaji i webhookovi kao u produkciji, s oglednim podacima koje možete slobodno mijenjati.

Prijeđite na svoju tvrtku

Novi ključevi za vašu tvrtku, u našem oblaku u EU-u ili vašem podatkovnom centru. Vaš se kôd ne mijenja.

Pitanja

Za razvojne inženjere.

Postoji li jedinstveni API za sve?

Da. Svaki zaslon u sustavu HONESTAS izgrađen je na istom API-ju koji koriste i vaši sustavi, s istim ovlastima, ograničenjima i zapisima. HONESTAS radi na platformi Adverant Nexus, našoj platformi za orkestraciju umjetne inteligencije, zbog čega je API isti u našem oblaku u EU-u i u vašem vlastitom podatkovnom centru.

Kako funkcioniraju ključevi?

Svaki ključ pripada jednoj skripti ili sustavu, smije obavljati samo zadatke koje mu dodijelite, pristupa samo jedinicama koje odaberete i istječe na datum koji postavite. Svaki poziv koji uputi bilježi se, a ključ se može zamijeniti bez prekida u radu.

Može li API zapisivati u naš sustav za obradu šteta?

HONESTAS čita vaše sustave za police, štete i modele te ih nikada ne zamjenjuje. Kada odluku treba upisati natrag, to ide kroz provjereni korak koji se bilježi, a nikada kao izravno ažuriranje.

Kako izgledaju odbijanja putem API-ja?

Iste oznake koje vide i korisnici, kao što su AUTHORITY_EXCEEDED ili SCOPE_REFUSED, uz jasno obrazloženje i sljedeći korak. Pogledajte što sustav odbija.

Koji su programski jezici podržani?

API koristi čisti HTTP i JSON, tako da radi s bilo kojim jezikom. Prodajni SDK dostupan je za web, iOS i Android, a biblioteka za provjeru za najčešće poslužiteljske jezike.

Saznajte više

Rezervirajte demo

Povežite svoj prvi sustav.

Pripremite sustav koji treba primiti obavijest kada je odštetni zahtjev zapečaćen. Postavit ćemo vaš sandbox i zajedno s vama povezati prvi webhook.

Zatražite pristup sandboxu Povežite svoje sustave