Tóg ar an taifead. Seiceáil é ó do chórais féin.
Gach rud a dhéanann daoine in HONESTAS, is féidir le do chórais é a dhéanamh tríd an API, leis na ceadanna, na ballaí agus na taifid chéanna. Léigh agus fíoraigh taifid shéalaithe, faigh teagmhais de réir mar a tharlaíonn siad, nasc gníomhairí do chomhpháirtithe agus cuir aistear luachana ar do shuíomh féin.
POST ‹an críochphointe fíoraithe›
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"]
}Taifead amháin, i bhformáid oscailte is féidir leat a léamh.
Is cáipéis JSON amháin é gach cinneadh séalaithe, agus is comhad díobh sin é Pas Cinnteoireachta. Tá an fhormáid foilsithe, ionas go léann do chórais, d'iniúchóir agus do chomhpháirtithe an rud céanna a léimid.
- Cé a rinne an cinneadh, faoi cén t-údarás agus cén leagan
- Gach píosa fianaise lena mhéarlorg féin
- Na táblaí agus an fhoclaíocht ar pionnaíodh é leo
- An séala, an stampa ama seachtrach agus na comhshínithe
{
"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 }
}Taifead éilimh séalaithe, giorraithe
Seiceáil taifead gan ceist a chur orainn.
Seol an comhad chuig an gcríochphointe fíoraithe, nó rith an leabharlann fhíoraithe fhoilsithe ar do mheaisíní féin gan glaoch ar bith ar HONESTAS. Tugann an dá rud na trí bhreith chéanna. Tagann na seoltaí cruinne agus an leabharlann do do theanga féin le rochtain ar an mbosca gainimh.
- holds
Meaitseálann gach méarlorg a shéala, éiríonn leis an tseiceáil ar an stampa ama agus tá na comhshínithe i láthair.
- changed
Tá rud éigin sa chomhad difriúil ón méid a séalaíodh. Ainmníonn an freagra an taifead agus an chuid, leis an gcód
HASH_MISMATCH. - bailí, leagan níos nuaí
Tá an taifead slán, agus cuireadh ceann nua in áit tábla nó fhoclaíochta ar ceanglaíodh é leis ó shin.
// an leabharlann fíoraitheora fhoilsithe, suiteáilte ar do mheaisín féin
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// ní sheoltar aon rud go dtí aon áit
console.log(result.verdict); // "holds"An leabharlann fíoraitheora, as líne
Gach rud a tharlaíonn, in ord, ón áit ar stad tú.
Léigh teagmhais in ord ón suíomh deireanach a bhí agat, scagtha de réir cineáil. Iompraíonn gach teagmhas an taifead lena mbaineann sé, ionas gur féidir le do chórais an taifead iomlán a fháil nuair a bhíonn sé uathu.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹críochphointe na dteagmhas›
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"
}Cloiseann do chórais é an nóiméad a shéalaítear taifead.
Roghnaigh na teagmhais do gach críochphointe. Sínítear gach seachadadh, ionas gur féidir le do chórais muinín a bheith acu as, agus déantar iarracht eile ar sheachadadh ar theip air agus mínítear é ar leathanach an chríochphointe féin.
- Sínithe le rún nach bhfuil ach ag do chríochphointe féin
- Atriailte, in ord, go dtí go bhfreagraíonn do chríochphointe
- Taispeánann gach seachadadh cad a seoladh agus cad a tháinig ar ais
const sig = req.headers[SIGNATURE_HEADER]; // ainmnithe ar leathanach an chríochphointe
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); // do chóras féin
}Seiceáil an síniú ar dtús
Labhraíonn gníomhairí do chomhpháirtithe le do chuidse, faoi chomhaontú i scríbhinn.
Ceanglaíonn bróicéirí, sealbhóirí cumhdaigh (coverholders) agus athárachóirí a ngníomhairí IS le do chuidse thar an bprótacal oscailte Agent2Agent. Ainmníonn gach nasc an comhaontú faoina n-oibríonn sé agus an méid is féidir le gach taobh a iarraidh.
- Síníonn an gníomhaire a sheol é gach iarratas
- Na scileanna a cheadaíonn an comhaontú amháin, dada eile
- Diúltaítear d'iarratas lasmuigh den chomhaontú agus taifeadtar é
- Coinnítear gach malartú ar thaifid an dá ghnólacht
{
"name": "Northgate Mutual · bordereaux",
"url": "https://agents.northgate.example/bordereaux",
"agreement": "CA-118",
"skills": [
{ "id": "bordereau.submit" },
{ "id": "claim.status" }
],
"auth": "iarratas sínithe, eochair amháin in aghaidh an chomhpháirtí"
}Cárta gníomhaire, foilsithe in aghaidh an chomhpháirtí
Aistear luachana ar do shuíomh, leis na nochtaí glasáilte isteach.
Cuireann SDK an éadain siopa aistir luachana, ceannaigh agus éilimh HONESTAS ar shuíomh gréasáin bróicéara nó árachóra féin agus ina n-aipeanna iOS agus Android féin. Is leatsa an branda. Ní féidir scipeáil thar na doiciméid nach mór do chustaiméir a fheiceáil sula n-íocann sé.
// SDK an éadain siopa don ghréasán, lódáilte ar do leathanach
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Ceannaithe ar líne");
});Aistear luachana brandáilte, i gcúpla líne
Tosaíonn rochtain ar an mbosca gainimh le taispeántas.
Tugaimid gnólacht bosca gainimh lán d'éilimh, de pholasaithe agus de thaifid shamplacha do gach foireann, ionas gur féidir leat glaoch ar gach críochphointe sula gceanglaíonn tú córas fíor.
Cuir taispeántas in áirithe
Inis dúinn cad is mian leat a cheangal: córas éileamh, comhpháirtí, éadan siopa nó uirlisí d'iniúchóra.
Faigh bosca gainimh
Árachóir samplach lena éilimh, lena sheomraí, lena dhiúltuithe agus lena thaifid shéalaithe féin, agus eochracha a dhéanann post amháin an ceann.
Tóg ina choinne
An API, na teagmhais agus na crúcaí gréasáin céanna leis an gcóras beo, le sonraí samplacha ar féidir leat iad a bhriseadh.
Bog go dtí do ghnólacht féin
Eochracha nua do do ghnólacht féin, inár néal san AE nó i d'ionad sonraí féin. Ní athraíonn do chód.
d'fhorbróirí.
An bhfuil API amháin ann do gach rud?
Tá. Tá gach scáileán in HONESTAS tógtha ar an API céanna a úsáideann do chórais, leis na ceadanna, na ballaí agus na taifid chéanna. Ritheadh HONESTAS ar Adverant Nexus, ár n-ardán ceolfhoirne IS, agus sin an fáth gur ionann an API inár néal san AE agus i d'ionad sonraí féin.
Conas a oibríonn eochracha?
Baineann gach eochair le script nó le córas amháin, ní fhéadfaidh sí ach na tascanna a thugann tú di a dhéanamh, ní shroicheann sí ach na haonaid a roghnaíonn tú agus tagann deireadh léi ar dháta a shocraíonn tú. Taifeadtar gach glao a dhéanann sí, agus is féidir í a rothlú gan aga neamhfhónaimh.
An féidir leis an API scríobh chuig ár gcóras éileamh?
Léann HONESTAS do chórais pholasaí, éileamh agus samhla agus ní chuireann sé riamh ina n-áit. Nuair is gá cinneadh a scríobh ar ais, téann sé trí chéim sheiceáilte a thaifeadtar, ní nuashonrú díreach riamh.
Cén chuma atá ar dhiúltuithe tríd an API?
Na cóid chéanna a fheiceann daoine, amhail AUTHORITY_EXCEEDED nó SCOPE_REFUSED, le cúis shoiléir agus an chéad chéim eile. Féach an méid a dhiúltaíonn sé.
Cé na teangacha a dtugtar tacaíocht dóibh?
Is HTTP agus JSON simplí é an API, mar sin oibríonn aon teanga ríomhchlárúcháin. Tagann SDK an éadain siopa don ghréasán, iOS agus Android, agus an leabharlann fíoraitheora do na teangacha freastalaí is coitianta.
Téigh níos doimhne
Ceangail do chéad chóras.
Tabhair leat an córas a dteastaíonn uaidh a fháil amach nuair a shéalaítear éileamh. Cuirfimid do bhosca gainimh ar bun agus ceanglóimid an chéad webhook leat.