Ndërtoni mbi regjistrimin. Kontrollojeni nga sistemet tuaja.
Gjithçka që njerëzit bëjnë në HONESTAS, sistemet tuaja mund ta bëjnë përmes API-t, me të njëjtat leje, barriera dhe regjistrime. Lexoni dhe verifikoni regjistrimet e vulosura, merrni ngjarjet në kohë reale, lidhni agjentët e partnerëve tuaj dhe vendosni një proces kuotimi në faqen tuaj.
POST ‹pika fundore e verifikimit›
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"]
}Një regjistrim, në një format të hapur që mund ta lexoni.
Çdo vendim i vulosur është një dokument i vetëm JSON, dhe një Pasaportë Vendimi është një skedar që i përmban ato. Formati është i publikuar, kështu që sistemet tuaja, auditori juaj dhe partnerët tuaj lexojnë të njëjtën gjë si ne.
- Kush vendosi, nën cilin autorizim dhe version
- Çdo provë me gjurmën e saj dixhitale
- Tabelat dhe kushtet e policës (wordings) ku është fiksuar
- Vula, vula kohore e jashtme dhe kundërnënshkrimet
{
"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 }
}Një regjistrim dëmi i vulosur, i shkurtuar
Kontrolloni një regjistrim pa na pyetur ne.
Dërgoni skedarin te pika fundore e verifikimit, ose ekzekutoni librarinë e publikuar të verifikuesit në serverët tuaj pa asnjë thirrje drejt HONESTAS. Të dyja japin të njëjtat tri verdikte. Qasja në sandbox vjen me adresat e sakta dhe librarinë për gjuhën tuaj të programimit.
- holds
Çdo gjurmë dixhitale përputhet me vulën e saj, vula kohore është e vlefshme dhe kundërnënshkrimet janë të pranishme.
- changed
Diçka në skedar ndryshon nga ajo që është vulosur. Përgjigjja identifikon regjistrimin dhe pjesën përkatëse, me kodin
HASH_MISMATCH. - qëndron, version më i ri
Regjistrimi është i paprekur, ndërsa një tabelë ose formulim me të cilin ishte lidhur është zëvendësuar ndërkohë.
// libraria e publikuar e verifikimit, e instaluar në kompjuterin tuaj
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// asgjë nuk dërgohet askund
console.log(result.verdict); // "holds"Libraria e verifikimit, jashtë linje
Çdo gjë që ndodh, sipas radhës, aty ku e latë.
Lexoni ngjarjet sipas radhës nga pozicioni juaj i fundit, të filtruara sipas llojit. Çdo ngjarje mban regjistrimin të cilit i përket, kështu që sistemet tuaja mund të marrin regjistrimin e plotë kur u nevojitet.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹pikëmbërritja e ngjarjeve›
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"
}Sistemet tuaja e marrin vesh në momentin që vuloset një regjistrim.
Zgjidhni ngjarjet për çdo pikëmbërritje (endpoint). Çdo dërgim është i nënshkruar, në mënyrë që sistemet tuaja t'i besojnë, dhe një dërgim i dështuar rishikohet dhe shpjegohet në faqen e vetë pikëmbërritjes.
- E nënshkruar me një sekret që e mban vetëm pikëmbërritja juaj
- Riprovohet, sipas radhës, derisa pikëmbërritja juaj të përgjigjet
- Çdo dërgim tregon çfarë u dërgua dhe çfarë u kthye
const sig = req.headers[SIGNATURE_HEADER]; // e emërtuar në faqen e pikëmbërritjes
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); // sistemi juaj
}Kontrolloni nënshkrimin në fillim
Agjentët e partnerëve tuaj flasin me tuajt, sipas një marrëveshjeje me shkrim.
Brokerat, coverholder-at dhe risiguruesit lidhin agjentët e tyre të IA-së me tuajt përmes protokollit të hapur Agent2Agent. Çdo lidhje emërton marrëveshjen sipas së cilës punon dhe çfarë mund të kërkojë secila palë.
- Çdo kërkesë nënshkruhet nga agjenti që e dërgoi atë
- Vetëm aftësitë që lejon marrëveshja, asgjë tjetër
- Një kërkesë jashtë marrëveshjes refuzohet dhe regjistrohet
- Çdo shkëmbim ruhet në regjistrimet e të dyja firmave
{
"name": "Northgate Mutual · bordereaux",
"url": "https://agents.northgate.example/bordereaux",
"agreement": "CA-118",
"skills": [
{ "id": "bordereau.submit" },
{ "id": "claim.status" }
],
"auth": "kërkesë e nënshkruar, një çelës për çdo partner"
}Një kartë agjenti, e publikuar për çdo partner
Një rrugëtim kuotimi në faqen tuaj, me informimet e detyrueshme të përfshira.
SDK e vitrinës (storefront) vendos rrugëtimet e kuotimit, blerjes dhe dëmeve të HONESTAS në faqen e internetit të vetë brokerit ose siguruesit dhe në aplikacionet e tyre iOS dhe Android. Marka është e juaja. Dokumentet që një klient duhet të shohë përpara se të paguajë nuk mund të anashkalohen.
// SDK e vitrinës për ueb, e ngarkuar në faqen tuaj
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Blerë online");
});Një rrugëtim kuotimi me markën tuaj, në pak rreshta
Qasja në sandbox fillon me një demonstrim.
Ne i japim çdo ekipi një firmë sandbox plot me dëme, polica dhe regjistrime shembull, në mënyrë që të mund të thërrisni çdo pikëmbërritje përpara se të lidhni një sistem real.
Rezervoni një demonstrim
Na tregoni çfarë dëshironi të lidhni: një sistem dëmesh, një partner, një vitrinë dixhitale ose mjetet e auditorit tuaj.
Merrni një sandbox
Një sigurues shembull me dëmet, dhomat, refuzimet dhe regjistrimet e veta të vulosura, si dhe çelësa ku secili kryen një punë të vetme.
Ndërtoni mbi të
E njëjta API, ngjarje dhe webhook si në prodhim, me të dhëna shembull që mund t'i testoni lirisht.
Kaloni në firmën tuaj
Çelësa të rinj për firmën tuaj, në renë tonë kompjuterike në BE ose në qendrën tuaj të të dhënave. Kodi juaj nuk ndryshon.
Për zhvilluesit.
A ka një API të vetme për gjithçka?
Po. Çdo ekran në HONESTAS është ndërtuar mbi të njëjtën API që përdorin sistemet tuaja, me të njëjtat leje, ndarje dhe regjistrime. HONESTAS funksionon në Adverant Nexus, platformën tonë të orkestrimit të IA-së, prandaj API është e njëjtë si në renë tonë në BE ashtu edhe në qendrën tuaj të të dhënave.
Si funksionojnë çelësat?
Çdo çelës i përket një skripti ose sistemi të vetëm, mund të kryejë vetëm detyrat që i jepni ju, arrin vetëm njësitë që zgjidhni dhe skadon në një datë që ju caktoni. Çdo thirrje që bën regjistrohet, dhe ai mund të zëvendësohet pa ndërprerje pune.
A mund të shkruajë API në sistemin tonë të dëmeve?
HONESTAS lexon sistemet tuaja të policave, dëmeve dhe modeleve dhe nuk i zëvendëson kurrë ato. Kur një vendim duhet të shkruhet mbrapsht, ai kalon përmes një hapi të kontrolluar që regjistrohet, kurrë si një përditësim i drejtpërdrejtë.
Si duken refuzimet përmes API-së?
Të njëjtat kode që shohin njerëzit, si p.sh. AUTHORITY_EXCEEDED ose SCOPE_REFUSED, me një arsye të qartë dhe hapin tjetër. Shikoni çfarë refuzon.
Cilat gjuhë programimi mbështeten?
API është HTTP dhe JSON i thjeshtë, kështu që çdo gjuhë funksionon. SDK e vitrinës vjen për ueb, iOS dhe Android, ndërsa libraria e verifikimit për gjuhët më të zakonshme të serverëve.
Mësoni më shumë
Lidhni sistemin tuaj të parë.
Sillni sistemin që duhet të njoftohet kur vuloset një dëm. Ne do të konfigurojmë mjedisin tuaj të testimit (sandbox) dhe do të lidhim së bashku webhook-un e parë.