Kūrėjams

Kurkite remdamiesi įrašu. Tikrinkite jį savo sistemose.

Viską, ką žmonės daro HONESTAS sistemoje, jūsų sistemos gali atlikti per API – su tais pačiais leidimais, ribomis ir įrašais. Nuskaitykite ir tikrinkite užantspauduotus įrašus, gaukite įvykius realiuoju laiku, prijunkite partnerių agentus ir įdiekite įmokos apskaičiavimo procesą savo svetainėje.

Gauti bandomosios aplinkos prieigą Įrašo formatas

Vienas atviras įrašo formatasPasirašyti „webhooks“ pranešimaiSąsajos tarp agentų

honestas · api · verify a passportPavyzdiniai duomenys

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

Patikrinkite pasą. Du įrašai galioja, išorinė laiko žyma patvirtinta, o viena iš naudotų lentelių turi naujesnę versiją.Pavyzdiniai duomenys

Įrašo formatas

Vienas įrašas atviru formatu, kurį galite nuskaityti.

Kiekvienas užantspauduotas sprendimas yra vienas JSON dokumentas, o sprendimų pasas (Decision Passport) – tokių dokumentų rinkmena. Formatas yra viešai skelbiamas, todėl jūsų sistemos, auditorius ir partneriai mato lygiai tą patį, ką ir mes.

Kas priėmė sprendimą, pagal kokius įgaliojimus ir kokią versiją
Kiekvienas įrodymas su savo unikaliu kontroliniu kodu
Lentelės ir sąlygų formuluotės, su kuriomis jis buvo susietas
Antspaudas, išorinė laiko žyma ir antrieji parašai

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

Užantspauduotas žalos įrašas (sutrumpintas)

Įrašo tikrinimas

Patikrinkite įrašą neklausdami mūsų.

Nusiųskite rinkmeną į tikrinimo galinį tašką arba paleiskite viešai prieinamą tikrinimo biblioteką savo serveriuose, visai nesikreipdami į HONESTAS. Abiem atvejais gausite vieną iš tų pačių trijų išvadų. Su bandomosios aplinkos prieiga gausite tikslius adresus ir biblioteką savo programavimo kalbai.

holds
Kiekvienas kontrolinis kodas atitinka savo antspaudą, laiko žyma patvirtinta, o antrieji parašai yra vietoje.
changed
Kažkas rinkmenoje skiriasi nuo to, kas buvo užantspauduota. Atsakyme nurodomas įrašas ir konkreti vieta su kodu HASH_MISMATCH.
galioja, yra naujesnė versija
Įrašas nepažeistas, o lentelė ar taisyklių redakcija, su kuria jis buvo susietas, vėliau buvo pakeista.

// paskelbta tikrinimo biblioteka, įdiegta jūsų kompiuteryje
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);

// niekas niekur nesiunčiama
console.log(result.verdict);   // "holds"

Tikrinimo biblioteka, veikianti neprisijungus

Įvykių API

Viskas, kas įvyksta, eilės tvarka, nuo ten, kur baigėte.

Skaitykite įvykius eilės tvarka nuo paskutinės pozicijos, filtruodami pagal tipą. Kiekviename įvykyje nurodytas įrašas, kuriam jis priklauso, todėl jūsų sistemos prireikus gali atsisiųsti visą įrašą.

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

GET ‹įvykių galutinis taškas›
    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"
}

Webhooks

Jūsų sistemos tai sužino tą pačią akimirką, kai įrašas užantspauduojamas.

Pasirinkite įvykius kiekvienam galutiniam taškui (endpoint). Kiekvienas pranešimas pasirašomas, todėl jūsų sistemos gali juo pasitikėti, o nepavykęs pristatymas kartojamas ir paaiškinamas to galutinio taško puslapyje.

Pasirašyta slaptu raktu, kurį turi tik jūsų galutinis taškas
Kartojama eilės tvarka, kol jūsų galutinis taškas atsako
Kiekviename pristatyme matyti, kas buvo išsiųsta ir koks gautas atsakymas

const sig = req.headers[SIGNATURE_HEADER];   // nurodyta galutinio taško puslapyje
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);   // jūsų sistema
}

Pirmiausia patikrinkite parašą

Agentas agentui (A2A)

Jūsų partnerių agentai bendrauja su jūsų agentais pagal rašytinį susitarimą.

Brokeriai, įgaliotieji tarpininkai (coverholders) ir perdraudikai sujungia savo DI agentus su jūsiškiais per atvirąjį „Agent2Agent“ protokolą. Kiekvienoje sąsajoje nurodomas susitarimas, pagal kurį ji veikia, ir tai, ko kiekviena šalis gali prašyti.

Kiekvieną užklausą pasirašo ją išsiuntęs agentas
Tik tie įgūdžiai, kuriuos leidžia susitarimas, ir nieko daugiau
Susitarimo neatitinkanti užklausa atmetama ir užregistruojama
Kiekvienas apsikeitimas duomenimis išsaugomas abiejų įmonių įrašuose

{
  "name": "Northgate Mutual · bordereaux",
  "url": "https://agents.northgate.example/bordereaux",
  "agreement": "CA-118",
  "skills": [
    { "id": "bordereau.submit" },
    { "id": "claim.status" }
  ],
  "auth": "signed request, one key per partner"
}

Agento kortelė, skelbiama kiekvienam partneriui

Pardavimo sąsajos SDK

Pasiūlymo gavimo kelias jūsų svetainėje su privalomu informacijos atskleidimu.

Klientų sąsajos SDK leidžia įdiegti HONESTAS pasiūlymo gavimo, įsigijimo ir žalos registravimo procesus paties brokerio ar draudiko svetainėje bei jų „iOS“ ir „Android“ programėlėse. Prekės ženklas – jūsų. Dokumentų, kuriuos klientas privalo pamatyti prieš mokėdamas, praleisti neįmanoma.

// klientų sąsajos žiniatinklio SDK, įkeltas jūsų puslapyje
const quote = storefront.mount("#quote", {
  brand: "tern-brokers",
  product: "home",
  language: "en-IE"
});

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

Jūsų prekės ženklo pasiūlymo gavimo kelias keliomis kodo eilutėmis

Brokerio prekės ženklu pažymėtas pasiūlymo kelias žingsnyje prieš mokėjimą, su poliso dokumentais, kuriuos klientas privalo perskaityti pirmiausia — **Prieš mokant.** Ketvirtas žingsnis iš penkių brokerio svetainėje: poliso santrauka, taisyklės ir nedraudžiamieji įvykiai, o tada – kaina su mokesčiais ir nurodytu brokerio atlygiu.Pavyzdiniai duomenys

**Prieš mokant.** Ketvirtas žingsnis iš penkių brokerio svetainėje: poliso santrauka, taisyklės ir nedraudžiamieji įvykiai, o tada – kaina su mokesčiais ir nurodytu brokerio atlygiu.Pavyzdiniai duomenys

Bandomoji aplinka

Prieiga prie testavimo aplinkos prasideda nuo demonstracijos.

Kiekvienai komandai suteikiame bandomąją įmonę su pavyzdinėmis žalomis, polisais ir įrašais, kad galėtumėte išbandyti kiekvieną galutinį tašką prieš prijungdami tikrą sistemą.

Užsisakyti demonstraciją

Pasakykite mums, ką norite prijungti: žalų sistemą, partnerį, klientų sąsają ar auditoriaus įrankius.

Gaukite testavimo aplinką

Pavyzdinis draudikas su savo žalomis, darbo erdvėmis, atmetimais bei užantspauduotais įrašais ir raktais, kurių kiekvienas atlieka po vieną užduotį.

Kurkite joje

Ta pati API, įvykiai ir „webhooks“ kaip ir darbinėje aplinkoje, su pavyzdiniais duomenimis, kuriuos nebaisu sugadini.

Perkelkite į savo įmonę

Nauji raktai jūsų įmonei – mūsų ES debesijoje arba jūsų duomenų centre. Jūsų kodas nesikeičia.

Klausimai

Kūrėjams.

Ar viskam naudojama viena API?

Taip. Kiekvienas HONESTAS ekranas sukurtas naudojant tą pačią API, kurią naudoja ir jūsų sistemos, su tais pačiais leidimais, apribojimais ir įrašais. HONESTAS veikia mūsų DI orkestravimo platformoje „Adverant Nexus“, todėl API yra tokia pati tiek mūsų ES debesijoje, tiek jūsų duomenų centre.

Kaip veikia raktai?

Kiekvienas raktas priklauso vienam scenarijui ar sistemai, gali atlikti tik jūsų priskirtas užduotis, pasiekia tik jūsų pasirinktus padalinius ir galioja iki jūsų nustatytos datos. Kiekviena jo užklausa įrašoma, o patį raktą galima pakeisti nestabdant veiklos.

Ar API gali įrašyti duomenis į mūsų žalų sistemą?

HONESTAS nuskaito jūsų polisų, žalų ir modelių sistemas, bet niekada jų nepakeičia. Kai sprendimą reikia įrašyti atgal, tai daroma per patikrinamą ir registruojamą žingsnį, o ne tiesioginiu atnaujinimu.

Kaip per API atrodo atmetimai?

Tie patys kodai, kuriuos mato ir žmonės, pavyzdžiui, AUTHORITY_EXCEEDED arba SCOPE_REFUSED, su aiškia priežastimi ir tolesniu žingsniu. Žr. ką sistema atmeta.

Kokios programavimo kalbos palaikomos?

API naudoja įprastus HTTP ir JSON, todėl tinka bet kuri kalba. Klientų sąsajos SDK skirtas žiniatinkliui, „iOS“ ir „Android“, o tikrinimo biblioteka – populiariausioms serverių kalboms.

Išsamiau

Užsisakyti demonstraciją

Prijunkite savo pirmąją sistemą.

Atverkite sistemą, kuri turi žinoti, kada žala yra užantspauduota. Mes paruošime jūsų bandymų aplinką (sandbox) ir kartu su jumis sujungsime pirmąjį „webhook“ pranešimą.

Gauti bandomosios aplinkos prieigą Prijunkite savo sistemas