Bouw voort op het dossier. Controleer het vanuit uw eigen systemen.
Alles wat mensen in HONESTAS doen, kunnen uw systemen via de API doen, met dezelfde rechten, scheidingswanden en dossiers. Lees en verifieer verzegelde dossiers, ontvang gebeurtenissen zodra ze plaatsvinden, koppel de agents van uw partners en plaats een offertestraat op uw eigen website.
POST ‹het verificatie-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"]
}Eén dossier, in een open formaat dat u kunt lezen.
Elk verzegeld besluit is één JSON-document, en een Decision Passport is een bestand met meerdere daarvan. Het formaat is openbaar, zodat uw systemen, uw auditor en uw partners precies hetzelfde lezen als wij.
- Wie heeft besloten, onder welke bevoegdheid en versie
- Elk bewijsstuk met een eigen vingerafdruk
- De tabellen en polisvoorwaarden waaraan het is vastgepind
- Het zegel, het externe tijdstempel en de medeondertekeningen
{
"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 }
}Een verzegeld schadedossier, ingekort
Controleer een dossier zonder het ons te vragen.
Stuur het bestand naar het verificatie-endpoint, of draai de gepubliceerde verificatiebibliotheek op uw eigen servers zonder enige aanroep naar HONESTAS. Beide geven dezelfde drie oordelen. Bij sandbox-toegang ontvangt u de exacte adressen en de bibliotheek voor uw programmeertaal.
- holds
Elke vingerafdruk komt overeen met het zegel, het tijdstempel klopt en de medeondertekeningen zijn aanwezig.
- changed
Iets in het bestand wijkt af van wat is verzegeld. Het antwoord noemt het dossier en het specifieke onderdeel, met de code
HASH_MISMATCH. - geldig, nieuwere versie
Het dossier is intact en een tabel of polisvoorwaarde waaraan het was gekoppeld, is sindsdien vervangen.
// de gepubliceerde verificatiebibliotheek, geïnstalleerd op uw eigen machine
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// er wordt niets ergens naartoe verstuurd
console.log(result.verdict); // "holds"De verificatiebibliotheek, offline
Alles wat er gebeurt, op volgorde, vanaf waar u was gebleven.
Lees events op volgorde vanaf uw laatste positie, gefilterd op type. Elk event bevat het bijbehorende dossier, zodat uw systemen het volledige dossier kunnen ophalen wanneer dat nodig is.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹het events-endpoint›
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"
}Uw systemen vernemen het zodra een dossier wordt verzegeld.
Kies de events voor elk endpoint. Elke aflevering is ondertekend, zodat uw systemen erop kunnen vertrouwen. Een mislukte aflevering wordt opnieuw geprobeerd en toegelicht op de pagina van het endpoint zelf.
- Ondertekend met een geheim dat alleen uw endpoint bezit
- Opnieuw geprobeerd, op volgorde, tot uw endpoint antwoordt
- Elke aflevering toont wat er is verzonden en wat er terugkwam
const sig = req.headers[SIGNATURE_HEADER]; // vermeld op de pagina van het 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); // uw eigen systeem
}Controleer eerst de handtekening
De agents van uw partners spreken met die van u, onder een schriftelijke overeenkomst.
Makelaars, gevolmachtigden en herverzekeraars koppelen hun AI-agents aan die van u via het open Agent2Agent-protocol. Elke koppeling vermeldt de overeenkomst waaronder deze werkt en wat elke partij mag opvragen.
- Elk verzoek wordt ondertekend door de verzendende agent
- Alleen de vaardigheden die de overeenkomst toestaat, niets anders
- Een verzoek buiten de overeenkomst wordt geweigerd en vastgelegd
- Elke uitwisseling wordt in de administratie van beide kantoren bewaard
{
"name": "Northgate Mutual · bordereaux",
"url": "https://agents.northgate.example/bordereaux",
"agreement": "CA-118",
"skills": [
{ "id": "bordereau.submit" },
{ "id": "claim.status" }
],
"auth": "ondertekend verzoek, één sleutel per partner"
}Een agentkaart, gepubliceerd per partner
Een offertetraject op uw site, met verplichte informatie vast ingebouwd.
De storefront-SDK plaatst HONESTAS-trajecten voor offertes, afsluiten en schademeldingen op de eigen website van een makelaar of verzekeraar en in hun eigen iOS- en Android-apps. Het merk is van u. De documenten die een klant vóór betaling moet zien, kunnen niet worden overgeslagen.
// de storefront-SDK voor het web, geladen op uw pagina
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Online afgesloten");
});Een offertetraject in uw huisstijl, in een paar regels code
Toegang tot de sandbox begint met een demo.
We geven elk team een sandbox-omgeving vol voorbeeldschades, polissen en dossiers, zodat u elk endpoint kunt aanroepen voordat u een echt systeem koppelt.
Plan een demo
Vertel ons wat u wilt koppelen: een schadesysteem, een partner, een storefront of de tools van uw auditor.
Ontvang een sandbox
Een voorbeeldverzekeraar met eigen schades, kamers, weigeringen en verzegelde dossiers, en sleutels met elk één specifieke taak.
Bouw erop voort
Dezelfde API, events en webhooks als in productie, met voorbeelddata waarmee u vrij kunt testen.
Stap over naar uw eigen omgeving
Nieuwe sleutels voor uw eigen organisatie, in onze EU-cloud of uw eigen datacenter. Uw code verandert niet.
Voor ontwikkelaars.
Is er één API voor alles?
Ja. Elk scherm in HONESTAS is gebouwd op dezelfde API die uw systemen gebruiken, met dezelfde rechten, scheidingswanden en dossiers. HONESTAS draait op Adverant Nexus, ons AI-orkestratieplatform; daarom is de API in onze EU-cloud exact hetzelfde als in uw eigen datacenter.
Hoe werken sleutels?
Elke sleutel hoort bij één script of systeem, mag alleen de taken uitvoeren die u eraan toewijst, heeft alleen toegang tot de door u gekozen afdelingen en verloopt op een door u ingestelde datum. Elke aanroep wordt vastgelegd en de sleutel kan zonder downtime worden geroteerd.
Kan de API naar ons schadesysteem schrijven?
HONESTAS leest uw polis-, schade- en modelsystemen uit en vervangt deze nooit. Wanneer een besluit moet worden teruggeschreven, verloopt dat via een gecontroleerde en vastgelegde stap, nooit via een directe wijziging.
Hoe zien weigeringen eruit via de API?
Dezelfde codes die gebruikers zien, zoals AUTHORITY_EXCEEDED of SCOPE_REFUSED, met een duidelijke reden en de volgende stap. Zie wat wordt geweigerd.
Welke programmeertalen worden ondersteund?
De API gebruikt standaard HTTP en JSON, dus elke taal werkt. De storefront-SDK is beschikbaar voor web, iOS en Android, en de verificatiebibliotheek voor de meest gangbare servertalen.
Verder verdiepen
Koppel uw eerste systeem.
Neem het systeem mee dat moet weten wanneer een schadedossier verzegeld is. Wij richten uw sandbox in en sluiten samen met u de eerste webhook aan.