Ibnu fuq ir-rekord. Iċċekkjawh mis-sistemi tagħkom stess.
Dak kollu li n-nies jagħmlu f’HONESTAS, is-sistemi tagħkom jistgħu jagħmluh permezz tal-API, bl-istess permessi, ħitan u rekords. Aqraw u vverifikaw rekords issiġillati, irċievu avvenimenti hekk kif iseħħu, qabbdu l-aġenti tal-imsieħba tagħkom u poġġu vjaġġ ta’ kwotazzjoni fuq is-sit tagħkom stess.
POST ‹il-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"]
}Rekord wieħed, f’format miftuħ li tistgħu taqraw.
Kull deċiżjoni ssiġillata hija dokument JSON wieħed, u Decision Passport huwa fajl tagħhom. Il-format huwa ppubblikat, sabiex is-sistemi tagħkom, l-awditur tagħkom u l-imsieħba tagħkom jaqraw l-istess ħaġa li naqraw aħna.
- Min iddeċieda, taħt liema awtorità u verżjoni
- Kull biċċa evidenza bil-marka tas-swaba’ diġitali tagħha stess
- It-tabelli u l-wordings li kienet marbuta magħhom
- Is-siġill, it-timbru tal-ħin ta’ barra u l-kontrofirmi
{
"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 }
}Rekord ta’ klejm issiġillat, imqassar
Iċċekkjaw rekord mingħajr ma tistaqsu lilna.
Ibgħatu l-fajl lill-verify endpoint, jew ħaddmu l-librerija tal-verifikatur ippubblikata fuq il-magni tagħkom stess mingħajr ebda sejħa lil HONESTAS. It-tnejn jagħtu l-istess tliet verdetti. L-aċċess għas-sandbox jiġi bl-indirizzi eżatti u l-librerija għal-lingwa tagħkom.
- holds
Kull marka tas-swaba’ diġitali taqbel mas-siġill tagħha, it-timbru tal-ħin jiċċekkja u l-kontrofirmi huma preżenti.
- changed
Xi ħaġa fil-fajl hija differenti minn dak li ġie ssiġillat. It-tweġiba ssemmi r-rekord u l-parti, bil-kodiċi
HASH_MISMATCH. - jibqa' jgħodd, verżjoni aktar ġdida
Ir-rekord huwa intatt, u tabella jew kliem tal-polza li kien marbut magħhom ġew mibdula minn dakinhar 'l hawn.
// il-librerija tal-verifikatur ippubblikata, installata fuq il-magna tiegħek stess
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// xejn ma jintbagħat imkien
console.log(result.verdict); // "holds"Il-librerija tal-verifikatur, offline
Kulma jiġri, fl-ordni, minn fejn ħallejt.
Aqra l-avvenimenti fl-ordni mill-aħħar pożizzjoni tiegħek, iffiltrati skont it-tip. Kull avveniment iġorr ir-rekord li jappartjeni għalih, sabiex is-sistemi tiegħek ikunu jistgħu jiksbu r-rekord sħiħ meta jkollhom bżonnu.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹l-endpoint tal-avvenimenti›
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"
}Is-sistemi tiegħek jisimgħu b'dan fil-mument li rekord jiġi ssiġillat.
Agħżel l-avvenimenti għal kull endpoint. Kull kunsinna hija ffirmata, sabiex is-sistemi tiegħek ikunu jistgħu jafdawha, u kunsinna li tfalli terġa' tiġi ppruvata u spjegata fuq il-paġna tal-endpoint stess.
- Iffirmata b'sigriet li l-endpoint tiegħek biss iżomm
- Terġa' tiġi ppruvata, fl-ordni, sakemm l-endpoint tiegħek iwieġeb
- Kull kunsinna turi x'intbagħat u x'ġie lura
const sig = req.headers[SIGNATURE_HEADER]; // imsemmi fuq il-paġna tal-endpoint
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); // is-sistema tiegħek stess
}Iċċekkja l-firma l-ewwel
L-aġenti tal-imsieħba tiegħek ikellmu lil tiegħek, taħt ftehim bil-miktub.
Il-brokers, il-coverholders u r-riassiguraturi jikkonnettjaw l-aġenti tal-IA tagħhom ma' tiegħek permezz tal-protokoll miftuħ Agent2Agent. Kull konnessjoni ssemmi l-ftehim li taħdem taħtu u x'tista' titlob kull naħa.
- Kull talba hija ffirmata mill-aġent li bagħatha
- Il-ħiliet li jippermetti l-ftehim biss, xejn aktar
- Talba barra mill-ftehim tiġi rrifjutata u rreġistrata
- Kull skambju jinżamm fir-rekords taż-żewġ kumpaniji
{
"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"
}Kard tal-aġent, ippubblikata għal kull sieħeb
Vjaġġ ta' kwotazzjoni fuq is-sit tiegħek, bl-iżvelar ta' informazzjoni inkluż b'mod obbligatorju.
L-SDK tal-istorefront ipoġġi l-vjaġġi ta' kwotazzjoni, xiri u talba ta' HONESTAS fuq il-websajt tal-broker jew tal-assiguratur stess u fl-apps tagħhom tal-iOS u Android. Id-ditta hija tiegħek. Id-dokumenti li klijent irid jara qabel iħallas ma jistgħux jinqabżu.
// l-SDK tal-istorefront għall-web, mgħobbi fuq il-paġna tiegħek
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Bought online");
});Vjaġġ ta' kwotazzjoni bid-ditta tiegħek, fi ftit linji
L-aċċess għas-sandbox jibda b'demo.
Nagħtu lil kull tim kumpanija sandbox mimlija b'talbiet, poloz u rekords ta' kampjun, sabiex tkun tista' ssejjaħ kull endpoint qabel ma tikkonnettja sistema reali.
Ibbukkja demo
Għidilna x'tixtieq tikkonnettja: sistema tat-talbiet, sieħeb, storefront jew l-għodod tal-awditur tiegħek.
Ikseb sandbox
Assiguratur ta' kampjun bit-talbiet, kmamar, rifjuti u rekords issiġillati tiegħu stess, u keys li jagħmlu xogħol wieħed kull waħda.
Ibni fuqha
L-istess API, avvenimenti u webhooks bħall-produzzjoni, b'data ta' kampjun li tista' tkisser.
Għaddi għall-kumpanija tiegħek
Keys ġodda għall-kumpanija tiegħek stess, fil-cloud tagħna tal-UE jew fiċ-ċentru tad-data tiegħek. Il-kodiċi tiegħek ma jinbidilx.
Għall-iżviluppaturi.
Hemm API waħda għal kollox?
Iva. Kull skrin f'HONESTAS huwa mibni fuq l-istess API li jużaw is-sistemi tiegħek, bl-istess permessi, ħitan u rekords. HONESTAS jaħdem fuq Adverant Nexus, il-pjattaforma tagħna ta' orkestrazzjoni tal-IA, u huwa għalhekk li l-API hija l-istess fil-cloud tagħna tal-UE u fiċ-ċentru tad-data tiegħek stess.
Kif jaħdmu l-keys?
Kull key tappartjeni għal script jew sistema waħda, tista' tagħmel biss il-kompiti li tagħtiha, tilħaq biss l-unitajiet li tagħżel u tintemm f'data li tistabbilixxi int. Kull sejħa li tagħmel tiġi rreġistrata, u tista' tinbidel mingħajr waqfien fis-servizz.
L-API tista' tikteb fis-sistema tat-talbiet tagħna?
HONESTAS jaqra s-sistemi tal-poloz, tat-talbiet u tal-mudelli tiegħek u qatt ma jissostitwixxihom. Meta deċiżjoni tkun trid tinkiteb lura, tgħaddi minn pass iċċekkjat li jiġi rreġistrat, u qatt bħala aġġornament dirett.
Kif jidhru r-rifjuti permezz tal-API?
L-istess kodiċijiet li jaraw in-nies, bħal AUTHORITY_EXCEEDED jew SCOPE_REFUSED, b'raġuni ċara u l-pass li jmiss. Ara x'jirrifjuta.
Liema lingwi huma appoġġjati?
L-API hija HTTP u JSON sempliċi, għalhekk kwalunkwe lingwa taħdem. L-SDK tal-istorefront jiġi għall-web, iOS u Android, u l-librerija tal-verifikatur għall-aktar lingwi komuni tas-servers.
Idħol aktar fil-fond
Qabbad l-ewwel sistema tiegħek.
Ġib is-sistema li trid tkun taf meta claim tiġi ssiġillata. Aħna nwaqqfu s-sandbox tiegħek u nqabbdu l-ewwel webhook miegħek.