Construya sobre el registro. Verifíquelo desde sus propios sistemas.
Todo lo que las personas hacen en HONESTAS, sus sistemas pueden hacerlo mediante la API, con los mismos permisos, barreras y registros. Lea y verifique registros sellados, reciba eventos en tiempo real, conecte los agentes de sus socios e integre un flujo de cotización en su propia web.
POST ‹el endpoint de verificación›
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"]
}Un registro, en un formato abierto y legible.
Cada decisión sellada es un documento JSON, y un Pasaporte de Decisión es un archivo que los agrupa. El formato es público, de modo que sus sistemas, su auditor y sus socios leen exactamente lo mismo que nosotros.
- Quién tomó la decisión, con qué nivel de autorización y bajo qué versión
- Cada prueba documental con su propia huella digital
- Las tablas y clausulados a los que se vinculó
- El sello, el sello de tiempo externo y las refrendas
{
"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 }
}Un registro de siniestro sellado, abreviado
Compruebe un registro sin preguntarnos a nosotros.
Envíe el archivo al endpoint de verificación o ejecute la librería de verificación pública en sus propios servidores sin hacer ninguna llamada a HONESTAS. Ambos métodos devuelven los mismos tres veredictos. El acceso al sandbox incluye las direcciones exactas y la librería para su lenguaje de programación.
- holds
Cada huella digital coincide con su sello, el sello de tiempo es válido y las refrendas están presentes.
- changed
Algo en el archivo difiere de lo que se selló. La respuesta indica el registro y la sección afectada, con el código
HASH_MISMATCH. - válido, versión posterior
El registro está intacto y una tabla o condicionado al que estaba vinculado ha sido sustituido desde entonces.
// la librería de verificación publicada, instalada en su propio equipo
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// no se envía nada a ningún sitio
console.log(result.verdict); // "holds"La librería de verificación, sin conexión
Todo lo que ocurre, en orden, desde donde lo dejó.
Lea los eventos en orden desde su última posición, filtrados por tipo. Cada evento incluye el registro al que pertenece, para que sus sistemas puedan recuperar el registro completo cuando lo necesiten.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹el endpoint de eventos›
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"
}Sus sistemas se enteran en el instante en que se sella un registro.
Elija los eventos para cada endpoint. Cada entrega va firmada, para que sus sistemas puedan confiar en ella, y si una entrega falla se reintenta y se explica en la propia página del endpoint.
- Firmado con un secreto que solo conoce su endpoint
- Reintentado, en orden, hasta que su endpoint responde
- Cada entrega muestra qué se envió y qué se recibió
const sig = req.headers[SIGNATURE_HEADER]; // indicado en la página del 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); // su propio sistema
}Compruebe primero la firma
Los agentes de sus socios hablan con los suyos, bajo un acuerdo por escrito.
Corredores, coverholders y reaseguradoras conectan sus agentes de IA con los suyos mediante el protocolo abierto Agent2Agent. Cada enlace indica el acuerdo bajo el que opera y qué puede solicitar cada parte.
- Cada solicitud va firmada por el agente que la envió
- Solo las competencias que el acuerdo permite, nada más
- Toda solicitud fuera del acuerdo se rechaza y se registra
- Cada intercambio se conserva en los registros de ambas entidades
{
"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"
}Una ficha de agente, publicada por socio
Un proceso de tarificación en su web, con la información precontractual integrada.
El SDK de escaparate digital integra los flujos de tarificación, contratación y declaración de siniestros de HONESTAS en la propia web de un corredor o aseguradora y en sus aplicaciones de iOS y Android. La marca es la suya. Los documentos que el cliente debe ver antes de pagar no se pueden omitir.
// el SDK de escaparate digital para web, cargado en su página
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Bought online");
});Un proceso de tarificación con su marca, en pocas líneas
El acceso al entorno de pruebas empieza con una demostración.
Facilitamos a cada equipo una entidad de pruebas completa con siniestros, pólizas y registros de ejemplo, para que pueda llamar a cada endpoint antes de conectar un sistema real.
Solicitar una demo
Díganos qué quiere conectar: un sistema de siniestros, un socio, un escaparate digital o las herramientas de su auditor.
Obtenga un entorno de pruebas
Una aseguradora de ejemplo con sus propios siniestros, salas, rechazos y registros sellados, y claves con una única función cada una.
Desarrolle sobre él
La misma API, eventos y webhooks que en producción, con datos de ejemplo que puede alterar sin riesgo.
Pase a su entidad
Nuevas claves para su propia entidad, en nuestra nube de la UE o en su centro de datos. Su código no cambia.
Para desarrolladores.
¿Hay una única API para todo?
Sí. Cada pantalla de HONESTAS está construida sobre la misma API que utilizan sus sistemas, con los mismos permisos, barreras y registros. HONESTAS se ejecuta sobre Adverant Nexus, nuestra plataforma de orquestación de IA, razón por la cual la API es idéntica en nuestra nube de la UE y en su propio centro de datos.
¿Cómo funcionan las claves?
Cada clave pertenece a un script o sistema, solo puede ejecutar las tareas que usted le asigne, accede únicamente a las unidades que elija y caduca en la fecha que fije. Cada llamada que realiza queda registrada, y la clave puede rotarse sin interrupción del servicio.
¿Puede la API escribir en nuestro sistema de siniestros?
HONESTAS lee sus sistemas de pólizas, siniestros y modelos, y nunca los sustituye. Cuando es necesario volcar una decisión, se hace mediante un paso verificado que queda registrado, nunca mediante una actualización directa.
¿Cómo se ven los rechazos a través de la API?
Con los mismos códigos que ven las personas, como AUTHORITY_EXCEEDED o SCOPE_REFUSED, acompañados de un motivo claro y el siguiente paso. Consulte qué rechaza.
¿Qué lenguajes son compatibles?
La API es HTTP y JSON estándar, por lo que funciona con cualquier lenguaje. El SDK de escaparate digital está disponible para web, iOS y Android, y la librería de verificación para los lenguajes de servidor más habituales.
Profundizar
Conecte su primer sistema.
Traiga el sistema que necesita saber cuándo se sella un siniestro. Configuraremos su entorno de pruebas y conectaremos el primer webhook con usted.