HelloSafe

Milline on teie elukohariik?

Arendajaplatvorm

API, millega müüa reisikindlustust oma toote sees

Allkirjastatud konversiooni-API, jälgitavad süvalingid ja S2S postback sinu stacki. Tasuta liidestada ja tasuta päringu kohta: sulle makstakse komisjonitasu.

Tasuta sandbox võti Vaata konversiooni-API-t

Mis on API taga

Kataloog

50

Reisijat pakkumise kohta

Saad hinnastada 1 kuni 50 inimest ühe päringuga. Üle kümne reisija võtab üle grupitoode: sama hind inimese kohta, olenemata vanusest.

193

Elukohariiki

Reisija saab hinna olenemata sellest, millisest riigist ta väljub.

193

Sihtkohta

Kõik sihtkohad, sealhulgas riskipiirkonnad.

26

Keelt

Teekond, dokumendid ja kokkuvõte reisija enda keeles.

33

Valuutat

Hind kuvatakse reisija enda valuutas.

28

Kaitset

Tervis, abi, reis, pagas, vastutus, tegevused, expat. Piirmäärad ja omavastutused vastuses.

Mida sul pole vaja ehitada

Kolm asja, mida sa kunagi ei ehita

Ei mingit oma litsentsi

HelloSafe on registreeritud turustaja ja kannab vastavuse. Sina ehitad sisse kogemuse, mitte regulatsiooni.

Ei mingit kindlustusandjapõhist liidestust

Üks päring, kogu kataloog. Ühendused, tootemuudatused ja lepingudokumendid jäävad meie kanda.

Ei mingit müügimeest, kellele helistada

Sandbox võti on ühe kliki kaugusel sinu kontost. Ilma ülevaatuseta, ilma kaardita, ilma kohtumiseta.

Liidestusteed

Viis viisi HelloSafe ühendamiseks

Ühe pärastlõunaga paigaldatud jälgitavast lingist kuni hinnastamise REST API-ni: vali oma liidestustase. Sama kaitse, samad komisjonitasud.

Töös

Jälgitavad süvalingid

Üks jälgitav link sisu või kampaania kohta, koos Sub-ID-ga. Kiireim algus, ilma koodita.

  • Süvalingid lehe ja pakkumise kaupa
  • Sub-ID kampaania, sisu või müügikoha kaupa
  • 90-päevane atributsiooniküpsis, last-click
Töös

Konversiooni postbacki API

Teata Atlasele, kui omistatud müük saabub või muudab olekut. HMAC-allkirjastatud päring, olekumasin, idempotentne.

  • Allkirjastatud võtmed kutsuja kaupa (HMAC-SHA256)
  • Olekud: pending, validated, cancelled
  • Summa oma valuutas: komisjonitasu arvutab server
Töös

S2S postback sinu stacki

Saada konversioonid sinna, kus äri juhid: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow või BI webhook.

  • Standardsed S2S konnektorid
  • Webhook sinu BI-sse
  • CSV eksport
Töös

Hinnastamise REST API

Hinnasta reis mitme kindlustusandja juures, loo jälgitav müügilink ja vaata, mida reisija kaart katmata jätab. Üks võti kõige jaoks. Loo konto ja sandbox võti on ühe kliki kaugusel.

  • Reaalajas pakkumised mitmelt kindlustusandjalt
  • Jälgitav müügilink, atributsioon sisse ehitatud
  • Avalik dokumentatsioon ja OpenAPI spetsifikatsioon
Privaatne beeta

MCP server AI agentidele

Tüübitud tööriistad, et sinu LLM või agent saaks otsida, võrrelda ja sõlmida, tuginedes värsketele andmetele.

  • Tüübitud tööriistad Claude'ile, ChatGPT-le ja oma agentidele
  • Vastused tuginevad päris andmetele
  • Agentne checkout

Dokumentatsioon

Loe enne, kui ehitad

Dokumentatsioon on avalik ja inglise keeles. Ei mingit sisselogimist ega vormi: kõik, mida API vastab, on kirja pandud.

Kiire algus

Sandbox võti, allkirjastatud päring, esimesed hinnastatud pakkumised. Node, cURL ja PHP.

Kiire algus →

API viide

Otspunktid, reisi väljad, kaitsekoodid, veakoodid ja kvoodid.

API viide →

OpenAPI spetsifikatsioon

Masinloetav leping sinu kliendigeneraatori jaoks.

OpenAPI spetsifikatsioon →

API olek

API kontroll reaalajas, kättesaadavuse lubadused ja intsidentide logi.

API olek →

Konversiooni-API praktikas

Postbackist komisjonitasuni ühe allkirjastatud päringuga

Konversiooni-API töötab juba täna. Saadad omistatud müügi, Atlas seob selle lingiga, teisendab eurodesse ja arvutab komisjonitasu sinu määra järgi.

  1. 01

    Hangi võti

    Käivitusfaasis antakse võtmeid taotluse alusel. Saad key_id ja signing secreti, mis kehtivad ainult sinu liidestusele.

  2. 02

    Allkirjasta päring

    Arvuta saladuse HMAC-SHA256 üle timestamp.body ja saada päised x-atlas-key-id, x-atlas-timestamp ja x-atlas-signature. Replay aken on 5 minutit.

  3. 03

    Saada konversioon

    Saada ref ja externalOrderId ning brutosumma oma valuutas ja olek. Atlas lukustab kursi, arvutab komisjonitasu ja tagastab rakendatud oleku.

postback.js 
import { createHmac } from "node:crypto";

const secret = process.env.ATLAS_SIGNING_SECRET;
const body = JSON.stringify({
  ref: "hs-acme-7f3k9",
  externalOrderId: "ORDER-5821",
  amount: 89.90,
  currency: "USD",
  status: "validated"
});

const ts = Math.floor(Date.now() / 1000).toString();
const signature = "v1=" + createHmac("sha256", secret)
  .update(`${ts}.${body}`)
  .digest("hex");

await fetch("https://atlas.hellosafe.com/api/postback/conversion", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-atlas-key-id": "pbk_live_a1b2c3",
    "x-atlas-timestamp": ts,
    "x-atlas-signature": signature
  },
  body
});
// → 200 { ok: true, action: "inserted", status: "validated" }

Üks allkirjastatud päring. Atlas vastab rakendatud oleku ja arvutatud komisjonitasuga.

Payloadi viide

Päringu keha

JSON. ref ja externalOrderId on kohustuslikud, ülejäänu on valikuline. Kaasa saadetud komisjonitasu eiratakse: tõe allikas on pearaamat.

Väli Tüüp Kohustuslik Kirjeldus
ref string Jah Atributsiooni identifikaator kujul partnerCode-shortCode.
externalOrderId string Jah Sinu tellimuse number. Atlase poolel toimib idempotentsusvõtmena.
amount number Ei Müügi brutosumma, oma valuutas.
currency string (3) Ei ISO 4217 kood. Tundmatu valuuta salvestatakse needs_fx olekus ja hinnastatakse hiljem.
status enum Ei pending, validated või cancelled. Vaikimisi pending.
subId string Ei Kampaania või sisu alaidentifikaator sinu aruandluse jaoks.

Vastuse koodid

Mida API tagastab

Selged HTTP koodid. Keelatud olekusiirdeid ei rakendata kunagi vaikselt.

Kood Tähendus
200 Konversioon salvestatud. action: inserted, updated, transitioned või unchanged.
400 Puuduvad väljad, vigane ref või ref, mis ei kuulu lingi omanikule.
401 Vigane allkiri, võti või timestamp (5-minutiline aken).
404 Selle ref-i jaoks linki ei leitud.
409 Keelatud olekusiire: olekumasin keeldub sellest.
422 Summa ületab konversioonipõhise turvapiiri.

Autentimine ja turvalisus

Allkirjastatud, piiritletud, jälgitav

Igal kutsujal on oma võti ja oma saladus. Midagi ei jagata, kõike saab tühistada.

Võtmed kutsuja kaupa

Eraldi key_id ja signing secret iga liidestuse jaoks. Tühista üks, teisi puutumata.

HMAC-SHA256 allkiri

Allkiri katab timestamp.body baithaaval. Iga muudatus kehas muudab päringu kehtetuks.

Kaitse replay vastu

Päringud, mille timestamp erineb rohkem kui 5 minutit, lükatakse tagasi. Pealtkuulatud päringut ei saa uuesti esitada.

Idempotentne olekumasin

pending olekusse validated või cancelled; validated ainult olekusse cancelled; cancelled on lõplik. Sama oleku uuesti saatmine ei tee midagi.

Töökindlus ja tugi

Ehitatud püsima, vastavad inimesed

Konversiooni-API ja jälgitavad lingid töötavad Cloudflare'i edge-võrgus. Sellele saad tugineda kättesaadavuse, korduspäringute ja toe osas.

99.9%

Sihtkättesaadavus

Postbackid ja jälgitavad lingid töötavad Cloudflare Workersis automaatse ümberlülitusega. Ükski üksik piirkond ei saa teenust maha võtta.

300+

Edge asukohta

Päringuid teenindab lähim Cloudflare'i punkt; komisjonitasu ja valuutavahetus arvutatakse seejärel asünkroonselt, väljaspool sinu kassa kriitilist teed.

< 24h

Toe vastamisaeg

E-posti tugi vastab ühe tööpäeva jooksul. Liidestusküsimused jõuavad partnerite inseneritiimini, mitte anonüümsesse järjekorda.

5 min

Turvaline kordusaken

Idempotentne externalOrderId järgi: korda pärast iga ajalõppu topeltarvestuseta, ja pealtkuulatud päring on viie minuti pärast kasutu.

Olekuleht on avalik: API kontroll reaalajas, mida me lubame, ja iga intsident alates API avamisest. Sinu kontakt liidestuse ja intsidentide osas jääb partnertiim, kättesaadav kontaktilehelt. API olek →

AI agendid

Sinu agent kutsub tööriista, HelloSafe vastab päris hinnaga

MCP server pakub hinnastamist, võrdlust ja kaardikontrolli tüübitud tööriistadena. Ligipääs soovi korral.

Soovi korral

MCP server

Ei mingit kindlustusandjapõhist liidestust, ei mingit hinnastamisloogikat kirjutada, ei mingit regulatiivset torutööd. Sinu kopilot, sinu vestlusrobot või sinu broneerimisteekond kutsub tööriista ja saab tagasi päris pakkumise, piirmäärade ja dokumentidega. Räägi meile, mida sa ehitad.

Tehnilised küsimused

Mida tiimid enne liidestamist küsivad.

Kui palju API maksab?

Mitte midagi. Puudub liitumistasu, kuutasu platvormi eest ja päringupõhine tasu konversiooni-API-l või süvalinkidel. Teenid 50 % komisjonitasudest müügilt, mille sinu liidestus toob; see on programmi ainus rahavoog.

Kas hinnastamiseks on REST API?

Mõlemad töötavad. Konversiooni-API (postback) ja hinnastamise REST API: loo konto, tekita sandbox võti ühe klikiga ja taotle tootmisligipääsu, kui liidestus juba töötab.

Kuidas autentimine toimib?

Allkirjastatud võtmed kutsuja kaupa. Arvutad saladuse HMAC-SHA256 üle timestamp.body ja saadad selle päises x-atlas-signature, 5-minutilise replay aknaga. Vanem Bearer tee on olemas, kuni senised kutsujad üle lähevad.

Mis valuutas summa saata?

Brutosumma oma valuutas koos valuuta koodiga. Atlas lukustab kursi vastuvõtmisel, teisendab eurodesse (raamatupidamisvaluuta) ja arvutab komisjonitasu sinu määra järgi. Kaasa saadetud komisjonitasu eiratakse.

Kas postback on idempotentne?

Jah. Võti on externalOrderId: sama oleku uuesti saatmine ei tee midagi ja olekumasin keeldub keelatud siiretest koodiga 409, selle asemel et neid vaikselt rakendada.

Kas saan liidestuda Impacti, Partnerize'i või Awini kaudu?

Jah. Pakume standardset S2S postbacki, mis ühendub otse Impacti, Partnerize'i, Awini, Voluumi, RedTracki ja Everflowga. Konversioone saab saata ka oma BI webhooki või eksportida CSV-sse.

Kas teil on OpenAPI spetsifikatsioon?

Jah, avalik ja ilma sisselogimiseta. Viitleht genereeritakse sellest spetsifikatsioonist iga ehituse ajal, nii et dokumentatsioon ja leping ei saa lahku minna.

Kas toetate MCP-d?

Privaatses beetas. MCP server pakub hinnastamist, võrdlust ja sõlmimist tüübitud tööriistadena, mida sinu LLM või agent saab kutsuda.

Millisele kättesaadavusele ja toele võin loota?

Konversiooni-API ja jälgitavad lingid töötavad Cloudflare Workersis automaatse ümberlülitusega; sihime 99,9 % kättesaadavust. E-posti tugi vastab ühe tööpäeva jooksul ja liidestusküsimused jõuavad partnerite inseneritiimini. Olekuleht on avalik.

Kas Coach vajab teist võtit?

Ei. Üks võti avab kogu API: hinnastamise, jälgitavad lingid ja Coachi. Sama allkiri, sama loendur, samad kvoodid.

Tehniline või äriküsimus? Võtke meiega ühendust

Ehitame

Lisa reisikindlustus oma tootesse

Loo konto ja tekita sandbox võti ühe klikiga: kindlad näidisandmed, ühtegi kindlustusandjat ei kutsuta, midagi pole allkirjastada. Tootmisligipääs on lühike ülevaatus, kui liidestus juba töötab.

Tasuta sandbox võti Loe korduma kippuvaid küsimusi