Gradite na zapisu. Preverite ga iz svojih sistemov.
Vse, kar uporabniki počnejo v sistemu HONESTAS, lahko vaši sistemi izvajajo prek vmesnika API – z enakimi pravicami, omejitvami in zapisi. Berite in preverjajte zapečatene zapise, prejemajte dogodke v realnem času, povežite agente svojih partnerjev in vključite postopek izdelave ponudbe na svojo spletno stran.
POST ‹končna točka za preverjanje›
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"]
}En zapis v odprtem formatu, ki ga lahko berete.
Vsaka zapečatena odločitev je en dokument JSON, potni list odločitve (Decision Passport) pa je datoteka, ki jih združuje. Format je javno objavljen, zato vaši sistemi, vaš revizor in vaši partnerji berejo natanko tisto, kar beremo mi.
- Kdo je sprejel odločitev, na podlagi katerega pooblastila in katere različice
- Vsak dokaz s svojim lastnim prstnim odtisom
- Tabele in zavarovalni pogoji, na katere je bila odločitev vezana
- Pečat, zunanji časovni žig in sopodpisi
{
"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 škodni zapis, skrajšan prikaz
Preverite zapis, ne da bi vprašali nas.
Pošljite datoteko na končno točko za preverjanje ali pa zaženite objavljeno knjižnico za preverjanje na lastnih strežnikih – popolnoma brez klica v sistem HONESTAS. Obe poti vrneta iste tri možne izide. Dostop do peskovnika vključuje točne naslove in knjižnico za vaš programski jezik.
- holds
Vsak prstni odtis se ujema s svojim pečatom, časovni žig je veljaven in sopodpisi so prisotni.
- changed
Nekaj v datoteki se razlikuje od tistega, kar je bilo zapečateno. Odgovor navede zapis in spremenjeni del ter kodo
HASH_MISMATCH. - velja, novejša različica
Zapis je nedotaknjen, tabela ali zavarovalni pogoji, na katere je bil vezan, pa so bili medtem nadomeščeni.
// objavljena knjižnica za preverjanje, nameščena na vašem strežniku
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// nič se ne pošlje nikamor
console.log(result.verdict); // "velja"Knjižnica za preverjanje, brez povezave
Vse, kar se zgodi, po vrsti, od tam, kjer ste končali.
Berite dogodke po vrsti od zadnjega položaja, filtrirane po vrsti. Vsak dogodek vsebuje sklic na pripadajoči zapis, tako da lahko vaši sistemi po potrebi pridobijo celoten zapis.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹končna točka za dogodke›
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"
}Vaši sistemi so obveščeni v trenutku, ko je zapis zapečaten.
Izberite dogodke za vsako končno točko. Vsaka dostava je podpisana, zato ji vaši sistemi lahko zaupajo, neuspela dostava pa se ponovi in pojasni na strani same končne točke.
- Podpisano s skrivnim ključem, ki ga ima le vaša končna točka
- Ponovni poskusi po vrstnem redu, dokler se vaša končna točka ne odzove
- Vsaka dostava prikaže, kaj je bilo poslano in kaj vrnjeno
const sig = req.headers[SIGNATURE_HEADER]; // navedeno na strani končne 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š lastni sistem
}Najprej preverite podpis
Agenti vaših partnerjev komunicirajo z vašimi, na podlagi pisnega dogovora.
Zavarovalni posredniki, pooblaščeni sklenitelji (coverholders) in pozavarovalnice povežejo svoje AI-agente z vašimi prek odprtega protokola Agent2Agent. Vsaka povezava določa dogovor, na podlagi katerega deluje, in kaj sme posamezna stran zahtevati.
- Vsako zahtevo podpiše agent, ki jo je poslal
- Samo zmožnosti, ki jih dovoljuje dogovor, nič drugega
- Zahteva zunaj dogovora se zavrne in zabeleži
- Vsaka izmenjava se shrani v evidencah obeh družb
{
"name": "Northgate Mutual · bordereaux",
"url": "https://agents.northgate.example/bordereaux",
"agreement": "CA-118",
"skills": [
{ "id": "bordereau.submit" },
{ "id": "claim.status" }
],
"auth": "podpisana zahteva, en ključ na partnerja"
}Kartica agenta, objavljena za vsakega partnerja
Postopek izdelave ponudbe na vašem spletnem mestu, z vграjenimi obveznimi razkritji.
Komplet SDK za spletno prodajo postavi postopke za ponudbo, sklenitev in prijavo škode HONESTAS neposredno na spletno mesto posrednika ali zavarovalnice ter v njihove aplikacije za iOS in Android. Blagovna znamka je vaša. Dokumentov, ki jih mora stranka videti pred plačilom, ni mogoče preskočiti.
// SDK za spletno prodajo na spletu, naložen na vaši strani
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Kupljeno prek spleta");
});Postopek ponudbe pod vašo blagovno znamko, v nekaj vrsticah kode
Dostop do peskovnika se začne s predstavitvijo.
Vsaki ekipi dodelimo testno okolje (peskovnik) z vzorčnimi škodnimi zahtevki, policami in zapisi, da lahko preizkusite vsako končno točko, preden povežete produkcijski sistem.
Rezervirajte predstavitev
Povejte nam, kaj želite povezati: sistem za obravnavo škod, partnerja, spletno prodajno mesto ali orodja vašega revizorja.
Pridobite peskovnik
Vzorčna zavarovalnica z lastnimi škodnimi zahtevki, sobami, zavrnitvami in zapečatenimi zapisi ter ključi, od katerih je vsak namenjen enemu opravilu.
Razvijajte v njem
Enak API, dogodki in spletni klici (webhooks) kot v produkciji, z vzorčnimi podatki, ki jih lahko poljubno preizkušate.
Prehod na vašo družbo
Novi ključi za vašo družbo, v našem oblaku v EU ali v vašem podatkovnem centru. Vaša koda se ne spremeni.
Za razvijalce.
Ali obstaja en sam API za vse?
Da. Vsak zaslon v sistemu HONESTAS je zgrajen na istem API-ju, ki ga uporabljajo vaši sistemi, z enakimi pravicami, omejitvami dostopa in zapisi. HONESTAS deluje na Adverant Nexus, naši platformi za orkestracijo UI, zato je API enak v našem oblaku v EU in v vašem podatkovnem centru.
Kako delujejo ključi?
Vsak ključ pripada enemu skriptu ali sistemu, izvaja lahko le opravila, ki mu jih dodelite, dostopa le do enot, ki jih izberete, in poteče na datum, ki ga določite. Vsak klic, ki ga opravi, se zabeleži, ključ pa lahko zamenjate brez izpada delovanja.
Ali lahko API zapisuje v naš sistem za obravnavo škod?
HONESTAS bere podatke iz vaših sistemov za police, škode in modele ter jih nikoli ne nadomesti. Ko je treba odločitev zapisati nazaj, to poteka prek preverjenega koraka, ki se zabeleži, nikoli kot neposredna posodobitev.
Kako so zavrnitve videti prek API-ja?
Enake kode, kot jih vidijo uporabniki, na primer AUTHORITY_EXCEEDED ali SCOPE_REFUSED, z jasnim razlogom in naslednjim korakom. Poglejte, kaj sistem zavrne.
Kateri programski jeziki so podprti?
API temelji na standardnem HTTP in JSON, zato deluje v katerem koli jeziku. SDK za spletno prodajo je na voljo za splet, iOS in Android, knjižnica za preverjanje pa za najpogostejše strežniške jezike.
Poglobite se
Povežite svoj prvi sistem.
Povežite sistem, ki mora vedeti, kdaj je škodni zahtevek zapečaten. Skupaj z vami bomo vzpostavili vaše testno okolje (sandbox) in povezali prvi webhook.