Építsen a rekordra. Ellenőrizze saját rendszereiből.
Mindent, amit a felhasználók a HONESTAS-ban csinálnak, az Önök rendszerei is elvégezhetik az API-n keresztül, ugyanazokkal a jogosultságokkal, határokkal és rekordokkal. Olvassa és ellenőrizze a lezárt rekordokat, fogadja az eseményeket valós időben, kapcsolja össze partnerei ügynökeit, és építsen be ajánlatadási folyamatot a saját weboldalába.
POST ‹az ellenőrző végpont›
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"]
}Egyetlen rekord, nyílt, olvasható formátumban.
Minden lezárt döntés egyetlen JSON-dokumentum, a Döntési Útlevél (Decision Passport) pedig ezeket tartalmazó fájl. A formátum nyilvános, így az Önök rendszerei, könyvvizsgálójuk és partnereik pontosan ugyanazt olvassák, amit mi.
- Ki döntött, milyen jogkör és verzió alapján
- Minden egyes bizonyíték a saját digitális ujjlenyomatával
- A táblák és szerződési feltételek, amelyekhez rögzítették
- A pecsét, a külső időbélyegző és az ellenjegyzések
{
"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 }
}Lezárt kárrendezési rekord, rövidítve
Ellenőrizzen egy rekordot anélkül, hogy minket megkérdezne.
Küldje el a fájlt az ellenőrző végpontra, vagy futtassa a közzétett ellenőrző könyvtárat a saját gépein anélkül, hogy egyáltalán meghívná a HONESTAS-t. Mindkettő ugyanazt a három eredményt adja. A sandbox-hozzáférés tartalmazza a pontos címeket és az Önök programozási nyelvéhez való könyvtárat.
- holds
Minden ujjlenyomat egyezik a pecsétjével, az időbélyegző stimmel, és az ellenjegyzések megvannak.
- changed
Valami a fájlban eltér attól, amit lezártak. A válasz megnevezi a rekordot és az érintett részt, a következő kóddal:
HASH_MISMATCH. - érvényes, újabb verzió
A rekord sértetlen, a hozzá rögzített táblázatot vagy feltételszöveget azonban időközben lecserélték.
// a közzétett ellenőrző könyvtár, a saját gépére telepítve
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// semmit sem küld sehová
console.log(result.verdict); // "holds" (érvényes)Az ellenőrző könyvtár, offline
Minden, ami történik, sorrendben, onnan, ahol abbahagyta.
Olvassa ki az eseményeket sorrendben az utolsó pozíciótól kezdve, típus szerint szűrve. Minden esemény tartalmazza a hozzá tartozó rekord azonosítóját, így rendszerei szükség esetén lekérhetik a teljes rekordot.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹az eseményvégpont›
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"
}Rendszerei azonnal értesülnek, amint egy rekordot lezárnak.
Válassza ki az eseményeket az egyes végpontokhoz. Minden kézbesítés aláírt, így rendszerei megbízhatnak benne; a sikertelen kézbesítést pedig újrapróbáljuk és részletezzük a végpont saját oldalán.
- Olyan titkos kulccsal aláírva, amely csak az Ön végpontjánál van meg
- Sorrendben újrapróbálva, amíg a végpontja nem válaszol
- Minden kézbesítés mutatja az elküldött adatot és a kapott választ
const sig = req.headers[SIGNATURE_HEADER]; // a végpont oldalán megnevezve
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); // az Ön saját rendszere
}Először ellenőrizze az aláírást
Partnerei ügynökei kommunikálnak az Önéivel, írásos megállapodás alapján.
Az alkuszok, coverholderek és viszontbiztosítók a nyílt Agent2Agent protokollon keresztül kapcsolják össze saját MI-ügynökeiket az Önéivel. Minden kapcsolat megnevezi a hátteréül szolgáló megállapodást, valamint azt, hogy melyik fél mit kérdezhet.
- Minden kérést aláír az azt küldő ügynök
- Csak a megállapodásban engedélyezett műveletek, semmi más
- A megállapodáson kívüli kérést a rendszer elutasítja és rögzíti
- Minden adatcsere bekerül mindkét fél nyilvántartásába
{
"name": "Northgate Mutual · bordereaux",
"url": "https://agents.northgate.example/bordereaux",
"agreement": "CA-118",
"skills": [
{ "id": "bordereau.submit" },
{ "id": "claim.status" }
],
"auth": "aláírt kérés, partnerenként egy kulcs"
}Partnerenként közzétett ügynökkártya
Ajánlatkérési folyamat az Ön weboldalán, garantált tájékoztatással.
A storefront SDK segítségével a HONESTAS ajánlatkérési, szerződéskötési és kárbejelentési folyamatai beépíthetők az alkusz vagy a biztosító saját weboldalába, illetve iOS- és Android-alkalmazásaiba. A márka az Öné. Azokat a dokumentumokat, amelyeket az ügyfélnek fizetés előtt látnia kell, nem lehet átugrani.
// a webes storefront SDK, az Ön oldalán betöltve
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Online megkötve");
});Saját márkás ajánlatkérési folyamat, néhány sornyi kóddal
A tesztkörnyezet (sandbox) elérése egy demóval indul.
Minden csapatnak biztosítunk egy mintakárokkal, kötvényekkel és rekordokkal feltöltött tesztbiztosítót, így minden végpontot kipróbálhat, mielőtt éles rendszert csatlakoztatna.
Bemutató kérése
Mondja el, mit szeretne csatlakoztatni: kárrendezési rendszert, partnert, értékesítési felületet vagy az auditor eszközeit.
Kérjen tesztkörnyezetet
Mintabiztosító saját kárügyekkel, szobákkal, elutasításokkal és lezárt rekordokkal, valamint egy-egy konkrét feladatra szóló kulcsokkal.
Fejlesszen rá
Ugyanaz az API, események és webhookok, mint az éles környezetben, olyan mintaadatokkal, amelyeket nyugodtan elronthat.
Átállás a saját társaságára
Új kulcsok a saját társaságához, az EU-s felhőnkben vagy az Ön adatközpontjában. A kódja változatlan marad.
Fejlesztőknek.
Mindenhez egyetlen API tartozik?
Igen. A HONESTAS minden képernyője ugyanarra az API-ra épül, amelyet az Ön rendszerei is használnak, ugyanazokkal a jogosultságokkal, elhatárolásokkal és rekordokkal. A HONESTAS az Adverant Nexus MI-orkesztrációs platformunkon fut, ezért az API pontosan ugyanaz az EU-s felhőnkben és az Ön saját adatközpontjában is.
Hogyan működnek a kulcsok?
Minden kulcs egyetlen szkripthez vagy rendszerhez tartozik, csak a kijelölt feladatokat végezheti el, csak a kiválasztott egységeket érheti el, és a megadott dátumon lejár. Minden hívása rögzítésre kerül, és leállás nélkül cserélhető (rotálható).
Tud írni az API a kárrendezési rendszerünkbe?
A HONESTAS olvassa a kötvény-, kár- és modellrendszereit, de soha nem váltja ki azokat. Ha egy döntést vissza kell írni, az egy ellenőrzött, rögzített lépésen keresztül történik, soha nem közvetlen adatfelülírással.
Hogyan néznek ki az elutasítások az API-n keresztül?
Ugyanazok a kódok jelennek meg, amelyeket a felhasználók is látnak, például AUTHORITY_EXCEEDED vagy SCOPE_REFUSED, világos indoklással és a következő lépéssel. Lásd: mit utasít el a rendszer.
Mely programozási nyelvek támogatottak?
Az API egyszerű HTTP-t és JSON-t használ, így bármilyen nyelvvel működik. A storefront SDK webes környezethez, iOS-hez és Androidhoz érhető el, az ellenőrző könyvtár pedig a leggyakoribb szerveroldali nyelvekhez.
Részletesebben
Kapcsolja össze első rendszerét.
Hozza azt a rendszert, amelynek tudnia kell, ha egy kárügyet lezárnak. Beállítjuk a tesztkörnyezetét (sandbox), és Önnel közösen kötjük be az első webhookot.