Rakenna tietueen päälle. Tarkista se omista järjestelmistäsi.
Kaiken, mitä käyttäjät tekevät HONESTASissa, järjestelmänne voivat tehdä API-rajapinnan kautta samoilla käyttöoikeuksilla, palomuureilla ja tietueilla. Lue ja varmenna sinetöityjä tietueita, vastaanota tapahtumia reaaliajassa, yhdistä kumppaneidesi agentit ja tuo tarjouspolku omalle verkkosivullesi.
POST ‹varmennuspäätepiste›
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"]
}Yksi tietue, avoimessa ja luettavassa muodossa.
Jokainen sinetöity päätös on yksi JSON-dokumentti, ja Decision Passport on niistä koostuva tiedosto. Muoto on julkinen, joten omat järjestelmänne, tilintarkastajanne ja kumppaninne lukevat täsmälleen samaa tietoa kuin me.
- Kuka päätti, millä valtuudella ja millä versiolla
- Jokainen todiste varustettuna omalla sormenjäljellään
- Taulukot ja vakuutusehdot, joihin päätös on kiinnitetty
- Sinetti, ulkopuolinen aikaleima ja varmentavat allekirjoitukset
{
"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 }
}Sinetöity korvaustietue, lyhennetty
Tarkista tietue kysymättä meiltä.
Lähetä tiedosto varmennuspäätepisteeseen tai aja julkinen varmennuskirjasto omilla palvelimillasi ilman ainuttakaan kutsua HONESTASiin. Molemmat antavat samat kolme tulosta. Hiekkalaatikkopääsyn mukana saat tarkat osoitteet ja kirjaston omalle ohjelmointikielellesi.
- holds
Jokainen sormenjälki vastaa sinettiään, aikaleima täsmää ja varmentavat allekirjoitukset ovat mukana.
- changed
Jokin tiedostossa poikkeaa siitä, mitä sinetöitiin. Vastaus nimeää tietueen ja muuttuneen kohdan koodilla
HASH_MISMATCH. - pitää paikkansa, uudempi versio
Tietue on koskematon, mutta taulukko tai vakuutusehdot, joihin se oli sidottu, on sittemmin korvattu.
// julkaistu varmennuskirjasto, asennettuna omalle koneellesi
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// mitään ei lähetetä minnekään
console.log(result.verdict); // "holds"Varmennuskirjasto, offline-tilassa
Kaikki mitä tapahtuu, järjestyksessä siitä, mihin jäit.
Lue tapahtumat järjestyksessä viimeisimmästä kohdasta tyypin mukaan suodatettuna. Jokainen tapahtuma sisältää viitteen tietueeseen, johon se kuuluu, joten järjestelmänne voivat noutaa koko tietueen tarvittaessa.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹tapahtumien päätepiste›
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"
}Järjestelmänne saavat tiedon heti, kun tietue sinetöidään.
Valitse tapahtumat kullekin päätepisteelle. Jokainen toimitus on allekirjoitettu, jotta järjestelmänne voivat luottaa siihen, ja epäonnistunutta toimitusta yritetään uudelleen ja sen syy kerrotaan päätepisteen omalla sivulla.
- Allekirjoitettu salaisuudella, joka on vain päätepisteenne hallussa
- Yritetään uudelleen järjestyksessä, kunnes päätepisteenne vastaa
- Jokaisesta toimituksesta näkyy, mitä lähetettiin ja mitä palautui
const sig = req.headers[SIGNATURE_HEADER]; // nimetty päätepisteen sivulla
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); // oma järjestelmänne
}Tarkista allekirjoitus ensin
Kumppaneidenne agentit keskustelevat omienne kanssa, kirjallisen sopimuksen puitteissa.
Meklarit, coverholderit ja jälleenvakuuttajat yhdistävät tekoälyagenttinsa teidän agentteihinne avoimen Agent2Agent-protokollan kautta. Jokaisessa yhteydessä määritellään sopimus, jonka alaisuudessa se toimii, sekä se, mitä kumpikin osapuoli saa pyytää.
- Lähettävä agentti allekirjoittaa jokaisen pyynnön
- Vain sopimuksen sallimat toiminnot, ei mitään muuta
- Sopimuksen ulkopuolinen pyyntö hylätään ja kirjataan
- Jokainen tietojenvaihto tallennetaan molempien yritysten tietueisiin
{
"name": "Northgate Mutual · bordereaux",
"url": "https://agents.northgate.example/bordereaux",
"agreement": "CA-118",
"skills": [
{ "id": "bordereau.submit" },
{ "id": "claim.status" }
],
"auth": "allekirjoitettu pyyntö, yksi avain kumppania kohden"
}Kumppanikohtaisesti julkaistu agenttikortti
Tarjouspolku omalla sivustollanne, pakolliset tiedonannot lukittuina prosessiin.
Myyntikanavan SDK tuo HONESTASin tarjous-, osto- ja vahinkoilmoituspolut meklarin tai vakuutusyhtiön omalle verkkosivustolle sekä iOS- ja Android-sovelluksiin. Brändi on teidän. Asiakirjoja, jotka asiakkaan on nähtävä ennen maksamista, ei voi ohittaa.
// verkkosivuston myyntikanavan SDK, ladattuna omalle sivullenne
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Ostettu verkosta");
});Brändätty tarjouspolku muutamalla koodirivillä
Hiekkalaatikkoympäristön käyttö alkaa demolla.
Annamme jokaiselle tiimille oman hiekkalaatikkoyhtiön, joka on täynnä esimerkkivahinkoja, -vakuutuksia ja -tietueita, jotta voitte testata jokaista päätepistettä ennen oikean järjestelmän yhdistämistä.
Varaa esittely
Kerro meille, minkä haluat yhdistää: korvausjärjestelmän, kumppanin, myyntikanavan tai tarkastajan työkalut.
Hanki hiekkalaatikko
Esimerkkivakuutusyhtiö, jolla on omat vahinkotapaukset, työtilat, hylkäykset ja sinetöidyt tietueet sekä avaimet, jotka on rajattu yhteen tehtävään kerrallaan.
Rakenna sitä vasten
Sama API, samat tapahtumat ja samat webhookit kuin tuotannossa, sekä testiaineisto, jota voit vapaasti rikkoa.
Siirry omaan yhtiöösi
Uudet avaimet omalle yhtiöllesi joko EU-pilvessämme tai omassa konesalissanne. Koodinne ei muutu.
Kehittäjille.
Onko kaikelle yksi ja sama API?
Kyllä. Jokainen HONESTASin näkymä on rakennettu saman APIn päälle, jota omat järjestelmänne käyttävät, samoilla käyttöoikeuksilla, palomuureilla ja tietueilla. HONESTAS toimii Adverant Nexus -tekoälyn orkestrointialustallamme, minkä ansiosta API on täysin sama sekä EU-pilvessämme että omassa konesalissanne.
Miten avaimet toimivat?
Jokainen avain kuuluu yhdelle skriptille tai järjestelmälle, saa suorittaa vain sille annetut tehtävät, pääsee käsiksi vain valitsemiinne yksiköihin ja vanhenee asettamananne päivänä. Jokainen sen tekemä kutsu kirjataan, ja avain voidaan vaihtaa ilman käyttökatkoa.
Voiko API kirjoittaa suoraan korvausjärjestelmäämme?
HONESTAS lukee vakuutus-, korvaus- ja mallinnusjärjestelmiänne, mutta ei koskaan korvaa niitä. Kun päätös on vietävä takaisin järjestelmään, se kulkee tarkistetun ja kirjattavan vaiheen kautta – ei koskaan suorana päivityksenä.
Miltä hylkäykset näyttävät APIn kautta?
Samat koodit, jotka ihmisetkin näkevät, kuten AUTHORITY_EXCEEDED tai SCOPE_REFUSED, sekä selkeä syy ja seuraava vaihe. Katso mitä järjestelmä hylkää.
Mitä ohjelmointikieliä tuetaan?
API on tavallista HTTP:tä ja JSONia, joten mikä tahansa kieli toimii. Myyntikanavan SDK on saatavilla verkkosivuille, iOS:lle ja Androidille, ja varmennuskirjasto yleisimmille palvelinkielille.
Syvenny aiheeseen
Yhdistä ensimmäinen järjestelmäsi.
Tuo järjestelmä, jonka on saatava tieto korvauspäätöksen sinetöinnistä. Pystytämme testiympäristösi ja kytkemme ensimmäisen webhookin kanssasi.