HelloSafe

Milline on teie elukohariik?

Arendajaplatvorm

API, millega müüa reisikindlustust oma toote sees

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

Tasuta sandbox võti Vaata konversiooni-API-t

Mis on API taga

Kataloog

50

Reisijat pakkumise kohta

Saate 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 teil pole vaja ehitada

Kolm asja, mida te kunagi ei ehita

Ei mingit oma litsentsi

HelloSafe on registreeritud turustaja ja kannab vastavuse. Teie ehitate 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 teie 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: valige 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 atribuutimiskü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 teie stacki

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

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

Hinnastamise REST API

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

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

MCP server AI agentidele

Tüübitud tööriistad, et teie 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 teie 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. Saadate omistatud müügi, Atlas seob selle lingiga, teisendab eurodesse ja arvutab komisjonitasu teie määra järgi.

  1. 01

    Hangi võti

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

  2. 02

    Allkirjasta päring

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

  3. 03

    Saada konversioon

    Saatke 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 Teie 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 teie 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 saate 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 teie 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. Teie kontakt liidestuse ja intsidentide osas jääb partnertiim, kättesaadav kontaktilehelt. API olek →

AI agendid

Teie 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. Teie kopilot, teie vestlusrobot või teie broneerimisteekond kutsub tööriista ja saab tagasi päris pakkumise, piirmäärade ja dokumentidega. Rääkige meile, mida te ehitate.

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. Teenite 50% komisjonitasudest müügilt, mille teie liidestus toob; see on programmi ainus rahavoog.

Kas hinnastamiseks on REST API?

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

Kuidas autentimine toimib?

Allkirjastatud võtmed kutsuja kaupa. Arvutate saladuse HMAC-SHA256 üle timestamp.body ja saadate 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 teie 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, või webhooki teie BI-sse.

Kas teil on OpenAPI spetsifikatsioon?

Jah, avaldatud aadressil /openapi.json, OpenAPI 3.1 vormingus, koos täieliku viitega aadressil /platform/api/documentation. Konversiooni-API on dokumenteeritud eespool kirjeldatud lepinguga: otspunkt, allkirjastatud päised, payload ja vastuse koodid.

Kas toetate MCP-d?

Privaatses beetas. MCP server pakub hinnastamist, võrdlust ja sõlmimist tüübitud tööriistadena, mida teie 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

Looge konto ja tekitage 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