Arendajale

Tuginege kirjele. Kontrollige seda oma süsteemidest.

Kõike, mida inimesed teevad HONESTASes, saavad teie süsteemid teha API kaudu – samade õiguste, piirangute ja kirjetega. Lugege ja verifitseerige pitseeritud kirjeid, võtke sündmusi vastu reaalajas, ühendage partnerite agendid ja lisage pakkumise teekond oma veebilehele.

Taotle liivakasti ligipääsu Kirje vorming

Üks avatud kirjevormingAllkirjastatud veebihaagidAgentidevahelised ühendused

honestas · api · passi verifitseerimineNäidisandmed

POST ‹verifitseerimise lõpp-punkt›
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"]
}

Verifitseeri pass. Kaks kirjet peavad paika, väline ajatempel klapib ja ühest kasutatud tabelist on olemas uuem versioon.Näidisandmed

Kirje vorming

Üks kirje, avatud ja loetavas vormingus.

Iga pitseeritud otsus on üks JSON-dokument ning otsusepass (Decision Passport) on nendest koosnev fail. Vorming on avalik, seega loevad nii teie süsteemid, audiitor kui ka partnerid täpselt sedasama, mida meiegi.

Kes otsustas, millise volituse ja versiooni alusel
Iga tõend koos oma unikaalse sõrmejäljega
Tabelid ja tingimuste sõnastused, millega see seoti
Pitser, väline ajatempel ja kaasallkirjad

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

Pitseeritud kahjukirje, lühendatud

Verifitseeri kirje

Kontrollige kirjet meie poole pöördumata.

Saatke fail verifitseerimise lõpp-punkti või käivitage avalik verifitseerimisteek oma serverites ilma ühegi päringuta HONESTASele. Mõlemad annavad sama kolme võimalusega tulemuse. Liivakasti ligipääsuga saate täpsed aadressid ja oma programmeerimiskeelele vastava teegi.

holds
Iga sõrmejälg ühtib oma pitseriga, ajatempel klapib ja kaasallkirjad on olemas.
changed
Midagi failis erineb sellest, mis pitseeriti. Vastus nimetab kirje ja muudetud osa koos koodiga HASH_MISMATCH.
kehtib, uuem versioon
Kirje on muutmata, kuid tabel või tingimuste tekst, millega see seoti, on vahepeal asendatud.

// avalik verifitseerimisteek, paigaldatud teie enda masinasse
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);

// midagi ei saadeta kuhugi
console.log(result.verdict);   // "holds"

Verifitseerimisteek, võrguühenduseta

Sündmuste API

Kõik, mis toimub, järjekorras sealt, kus pooleli jäite.

Lugege sündmusi järjekorras alates viimasest asukohast, filtreerituna tüübi järgi. Iga sündmus sisaldab viidet oma kirjele, et teie süsteemid saaksid vajadusel pärida tervikkirje.

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

GET ‹sündmuste lõpp-punkt›
    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"
}

Veebihaagid

Teie süsteemid saavad teate kohe, kui kirje pitseeritakse.

Valige iga lõpp-punkti jaoks sobivad sündmused. Iga edastus on allkirjastatud, et teie süsteemid saaksid seda usaldada, ning ebaõnnestunud edastust proovitakse uuesti ja selgitatakse lõpp-punkti enda lehel.

Allkirjastatud saladusega, mida teab vaid teie lõpp-punkt
Proovitakse järjekorras uuesti, kuni teie lõpp-punkt vastab
Iga edastuse juures on näha, mis saadeti ja mis vastuseks tuli

const sig = req.headers[SIGNATURE_HEADER];   // nimetatud lõpp-punkti lehel
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);   // teie enda süsteem
}

Kontrollige esmalt allkirja

Agendilt agendile

Teie partnerite agendid suhtlevad teie omadega kirjaliku lepingu alusel.

Maaklerid, volitatud esindajad (coverholders) ja edasikindlustusandjad ühendavad oma tehisintellekti agendid teie omadega avatud Agent2Agent protokolli kaudu. Iga ühendus määratleb lepingu, mille alusel see töötab, ja selle, mida kumbki pool võib küsida.

Iga päring on selle saatnud agendi poolt allkirjastatud
Ainult lepinguga lubatud oskused, ei midagi muud
Lepingust väljuv päring lükatakse tagasi ja salvestatakse
Iga infovahetus talletatakse mõlema ettevõtte kirjetes

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

Partneripõhiselt avaldatud agendikaart

Storefront SDK

Pakkumise teekond teie veebilehel, kohustusliku teabega kindlalt paigas.

Müügikeskkonna SDK toob HONESTASe pakkumise, ostu ja kahjunõude esitamise teekonnad maakleri või kindlustusandja enda veebilehele ning iOS-i ja Androidi rakendustesse. Bränd on teie oma. Dokumente, mida klient peab enne maksmist nägema, ei saa vahele jätta.

// veebi müügikeskkonna SDK, laaditud teie lehele
const quote = storefront.mount("#quote", {
  brand: "tern-brokers",
  product: "home",
  language: "en-IE"
});

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

Teie brändiga pakkumise teekond mõne koodireaga

Maakleri bränditud pakkumise teekond vahetult enne maksmist koos poliisidokumentidega, millega klient peab eelnevalt tutvuma — **Enne maksmist.** Neljas samm viiest maakleri enda veebilehel: poliisi kokkuvõte, kindlustustingimused ja välistused, seejärel hind koos maksude ja maakleritasuga.Näidisandmed

**Enne maksmist.** Neljas samm viiest maakleri enda veebilehel: poliisi kokkuvõte, kindlustustingimused ja välistused, seejärel hind koos maksude ja maakleritasuga.Näidisandmed

Liivakast

Liivakasti ligipääs algab demoga.

Anname igale tiimile liivakasti-ettevõtte koos näidiskahjunõuete, poliiside ja kirjetega, et saaksite katsetada iga lõpp-punkti enne päris süsteemi ühendamist.

Broneeri demo

Öelge meile, mida soovite ühendada: kahjukäsitlussüsteemi, partneri, müügikeskkonna või audiitori tööriistad.

Hangi liivakast

Näidiskindlustusandja oma kahjunõuete, tööruumide, keeldumiste ja pitseeritud kirjetega ning võtmetega, millest igaüks täidab kindlat ülesannet.

Ehitage selle najal

Sama API, sündmused ja veebihaagid (webhooks) mis töökeskkonnas, koos näidisandmetega, mida võite julgelt katki teha.

Kolige oma ettevõttesse

Uued võtmed teie enda ettevõttele meie EL-i pilves või teie andmekeskuses. Teie kood ei muutu.

Korduma kippuvad küsimused

Arendajale.

Kas kõige jaoks on üks API?

Jah. Iga HONESTASe ekraanivaade põhineb samal API-l, mida kasutavad teie süsteemid, samade õiguste, piirangute ja kirjetega. HONESTAS töötab meie tehisintellekti orkestreerimisplatvormil Adverant Nexus, mistõttu on API ühesugune nii meie EL-i pilves kui ka teie enda andmekeskuses.

Kuidas võtmed töötavad?

Iga võti kuulub ühele skriptile või süsteemile, tohib täita vaid teie määratud ülesandeid, pääseb ligi ainult teie valitud üksustele ja aegub teie määratud kuupäeval. Iga võtmega tehtud päring salvestatakse ning võtit saab vahetada ilma töökatkestuseta.

Kas API saab kirjutada andmeid meie kahjukäsitlussüsteemi?

HONESTAS loeb teie poliisi-, kahju- ja mudelisüsteeme ega asenda neid kunagi. Kui otsus tuleb tagasi kirjutada, käib see läbi kontrollitud ja salvestatud sammu, mitte kunagi otseuuendusena.

Millised näevad keeldumised välja API kaudu?

Samad koodid, mida näevad kasutajad, näiteks AUTHORITY_EXCEEDED või SCOPE_REFUSED, koos selge põhjenduse ja järgmise sammuga. Vaadake, millest süsteem keeldub.

Milliseid programmeerimiskeeli toetatakse?

API kasutab tavalist HTTP-d ja JSON-it, seega sobib iga keel. Müügikeskkonna SDK on saadaval veebi, iOS-i ja Androidi jaoks ning verifitseerimisteek levinumate serverikeelte jaoks.

Uurige lähemalt

Broneeri demo

Ühendage oma esimene süsteem.

Võtke kaasa süsteem, mis peab teadma, millal kahjunõue pitseeritakse. Seadistame teie liivakasti ja ühendame koos teiega esimese veebihaagi.

Taotle liivakasti ligipääsu Ühendage oma süsteemid