Будуйте на основі запису. Перевіряйте його з власних систем.
Усе, що люди роблять у HONESTAS, ваші системи можуть робити через API — з тими самими правами доступу, розмежуваннями та записами. Зчитуйте й перевіряйте скріплені печаткою записи, отримуйте події в реальному часі, підключайте агентів ваших партнерів і вбудовуйте процес котирування на власному сайті.
POST ‹ендпоінт перевірки›
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"]
}Один запис у відкритому форматі, який можна прочитати.
Кожне скріплене печаткою рішення — це один документ JSON, а Паспорт рішення (Decision Passport) — це файл із такими документами. Формат є відкритим, тож ваші системи, ваш аудитор і ваші партнери читають те саме, що й ми.
- Хто ухвалив рішення, в межах яких повноважень і якої версії
- Кожен доказ із власним цифровим відбитком
- Таблиці та формулювання умов (wordings), до яких його було прив'язано
- Печатка, зовнішня позначка часу та контрасигнування
{
"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 }
}Скріплений печаткою запис щодо збитку, скорочено
Перевіряйте запис без звернення до нас.
Надішліть файл на ендпоінт перевірки або запустіть опубліковану бібліотеку верифікатора на власних серверах взагалі без звернення до HONESTAS. Обидва способи дають однакові три вердикти. Доступ до пісочниці містить точні адреси та бібліотеку для вашої мови програмування.
- holds
Кожен цифровий відбиток збігається зі своєю печаткою, позначка часу підтверджена, а контрасигнування наявні.
- changed
Щось у файлі відрізняється від того, що було скріплено печаткою. Відповідь вказує на конкретний запис і його частину з кодом
HASH_MISMATCH. - дійсний, є новіша версія
Запис цілісний, а таблицю чи формулювання поліса, до яких його було прив'язано, з того часу замінено.
// опублікована бібліотека верифікатора, встановлена на вашій власній машині
const file = await readFile("2026-1020-7741.json");
const result = await verifier.verify(file);
// нічого нікуди не надсилається
console.log(result.verdict); // "дійсний"Бібліотека верифікатора, офлайн
Усе, що відбувається, по черзі, з місця, де ви зупинилися.
Читання подій по черзі з останньої позиції, з фільтрацією за типом. Кожна подія містить посилання на запис, до якого вона належить, тож ваші системи можуть завантажити повний запис за потреби.
record.sealedrefusal.recordedroom.openedruling.signedpayment.heldpassport.issuedrecord.supersededcall.handed_over
GET ‹ендпоінт подій›
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"
}Ваші системи дізнаються про це в ту саму мить, коли запис запечатано.
Обирайте події для кожного ендпоінта. Кожна доставка підписується, тож ваші системи можуть їй довіряти, а у разі збою доставка повторюється з поясненням на сторінці самого ендпоінта.
- Підписано секретом, відомим лише вашому ендпоінту
- Повторні спроби по черзі, доки ваш ендпоінт не відповість
- Кожна доставка показує, що було надіслано і що надійшло у відповідь
const sig = req.headers[SIGNATURE_HEADER]; // вказано на сторінці ендпоінта
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); // ваша власна система
}Спочатку перевірте підпис
Агенти ваших партнерів спілкуються з вашими — на підставі письмової угоди.
Брокери, коверхолдери та перестраховики підключають своїх ШІ-агентів до ваших через відкритий протокол Agent2Agent. Кожне з'єднання фіксує угоду, за якою воно діє, і те, що кожна сторона має право запитувати.
- Кожен запит підписується агентом, який його надіслав
- Лише навички, дозволені угодою, і нічого більше
- Запит поза межами угоди відхиляється і записується
- Кожен обмін зберігається в записах обох компаній
{
"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"
}Картка агента, опублікована для кожного партнера
Розрахунок пропозиції на вашому сайті з обов'язковим розкриттям інформації.
SDK вітрини вбудовує сценарії розрахунку пропозиції, купівлі поліса та подання вимоги від HONESTAS на власний вебсайт брокера чи страховика та в їхні застосунки для iOS і Android. Бренд — ваш. Документи, які клієнт зобов'язаний побачити перед оплатою, неможливо пропустити.
// SDK вітрини для вебу, завантажений на вашій сторінці
const quote = storefront.mount("#quote", {
brand: "tern-brokers",
product: "home",
language: "en-IE"
});
quote.on("bound", (policy) => {
crm.note(policy.id, "Куплено онлайн");
});Брендований шлях розрахунку пропозиції у кілька рядків коду
Доступ до пісочниці починається з демо.
Ми надаємо кожній команді компанію-пісочницю, наповнену тестовими вимогами, полісами та записами, щоб ви могли протестувати кожен ендпоінт перед підключенням реальної системи.
Замовити демо
Розкажіть нам, що ви хочете підключити: систему врегулювання вимог, партнера, вітрину чи інструменти вашого аудитора.
Отримати пісочницю
Тестовий страховик із власними вимогами, кімнатами, відмовами та запечатаними записами, а також ключами, кожен з яких виконує лише одне завдання.
Розробляйте на її основі
Ті самі API, події та вебхуки, що й у робочому середовищі, з тестовими даними, які не страшно зламати.
Перехід до вашої компанії
Нові ключі для вашої компанії — у нашій хмарі в ЄС або у вашому дата-центрі. Ваш код змінювати не потрібно.
Для розробників.
Чи є єдиний API для всього?
Так. Кожен екран у HONESTAS побудований на тому самому API, який використовують ваші системи, з тими самими правами доступу, бар'єрами та записами. HONESTAS працює на базі Adverant Nexus — нашої платформи оркестрації ШІ, тому API однаковий як у нашій хмарі в ЄС, так і у вашому власному дата-центрі.
Як працюють ключі?
Кожен ключ належить одному скрипту чи системі, може виконувати лише призначені вами завдання, має доступ лише до обраних вами підрозділів і припиняє дію у встановлену вами дату. Кожен виклик ключа фіксується, а сам ключ можна оновити без простоїв у роботі.
Чи може API записувати дані в нашу систему врегулювання вимог?
HONESTAS зчитує дані з ваших систем обліку полісів, вимог і моделей, але ніколи не замінює їх. Коли рішення потрібно записати назад, це відбувається через контрольований крок, який фіксується, і ніколи — через пряме оновлення.
Як виглядають відмови через API?
Ті самі коди, які бачать люди, наприклад AUTHORITY_EXCEEDED або SCOPE_REFUSED, зі зрозумілою причиною та наступним кроком. Див. що система відхиляє.
Які мови програмування підтримуються?
API працює через звичайні HTTP та JSON, тому підійде будь-яка мова. SDK вітрини доступний для вебу, iOS та Android, а бібліотека верифікатора — для найпоширеніших серверних мов.
Детальніше
Підключіть свою першу систему.
Покажіть систему, яка має знати, коли рішення за збитком запечатано. Ми розгорнемо пісочницю і разом налаштуємо перший вебхук.