50
Potnikov na ponudbo
Ceno lahko izračunate za 1 do 50 oseb v enem klicu. Nad deset potnikov prevzame skupinski izdelek: ista cena na osebo, ne glede na starost.
Razvijalska platforma
API za prodajo potovalnega zavarovanja znotraj vašega izdelka
Podpisan konverzijski API, sledene deep povezave in S2S postback v vaš stack. Brezplačno za integracijo in brezplačno na klic: plačani ste s provizijo.
Kaj stoji za API-jem
Katalog
193
Držav bivanja
Potnik dobi ceno ne glede na to, iz katere države odhaja.
193
Destinacij
Vse destinacije, tudi tvegana območja.
26
Jezikov
Potek, dokumenti in povzetek v jeziku potnika.
33
Valut
Cena se prikaže v valuti potnika.
28
Kritij
Zdravje, asistenca, potovanje, prtljaga, odgovornost, aktivnosti, expat. Limiti in franšize v odgovoru.
Česa vam ni treba graditi
Tri stvari, ki jih ne boste nikoli gradili
Nobene lastne licence
HelloSafe je registrirani distributer in nosi skladnost. Vi vgradite izkušnjo, ne regulative.
Nobene integracije po zavarovalnici
En klic, celoten katalog. Povezave, spremembe izdelkov in pogodbeni dokumenti ostanejo pri nas.
Nobenega prodajalca za klic
Sandbox ključ je en klik od vašega računa. Brez pregleda, brez kartice, brez sestanka.
Poti integracije
Pet načinov za priklop HelloSafe
Od sledene povezave, postavljene v enem popoldnevu, do REST API-ja za izračun cene: izberite raven integracije. Enako kritje, enake provizije.
Sledene deep povezave
Ena sledena povezava na vsebino ali kampanjo, s Sub-ID. Najhitrejši začetek, brez kode.
- Deep povezave po strani in po ponudbi
- Sub-ID po kampanji, vsebini ali prodajnem mestu
- Piškotek atribucije za 90 dni, last-click
API konverzijskega postbacka
Sporočite Atlasu, ko pripisana prodaja prispe ali spremeni stanje. Zahteva podpisana s HMAC, avtomat stanj, idempotentno.
- Podpisani ključi na klicatelja (HMAC-SHA256)
- Stanja: pending, validated, cancelled
- Znesek v izvorni valuti: provizijo izračuna strežnik
S2S postback v vaš stack
Pošiljajte konverzije tja, kjer vodite posel: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow ali webhook v BI.
- Standardni S2S konektorji
- Webhook v vaš BI
- Izvoz v CSV
REST API za cene
Izračunajte ceno potovanja pri več zavarovalnicah, ustvarite sledeno prodajno povezavo in preverite, česa kartica potnika ne krije. En ključ za vse. Ustvarite račun in sandbox ključ je en klik stran.
- Ponudbe več zavarovalnic v realnem času
- Sledena prodajna povezava z vgrajeno atribucijo
- Javna dokumentacija in specifikacija OpenAPI
Strežnik MCP za agente UI
Tipizirana orodja, da vaš LLM ali agent išče, primerja in sklene, na podlagi svežih podatkov.
- Tipizirana orodja za Claude, ChatGPT in lastne agente
- Odgovori, oprti na resnične podatke
- Agentski checkout
Dokumentacija
Preberite, preden gradite
Dokumentacija je javna in v angleščini. Brez prijave, brez obrazca: vse, kar API vrne, je zapisano.
Hitri začetek
Sandbox ključ, podpisana zahteva, prve ovrednotene ponudbe. Node, cURL in PHP.
Hitri začetek →Referenca API
Končne točke, polja potovanja, oznake kritij, kode napak in kvote.
Referenca API →Specifikacija OpenAPI
Strojno berljiva pogodba za vaš generator odjemalca.
Specifikacija OpenAPI →Stanje API
Preverjanje API v živo, zaveze glede razpoložljivosti in dnevnik incidentov.
Stanje API →Konverzijski API v praksi
Od postbacka do provizije, v eni podpisani zahtevi
Konverzijski API deluje že danes. Pošljete pripisano prodajo, Atlas jo poveže s povezavo, pretvori v evre in izračuna provizijo po vaši stopnji.
- 01
Pridobite ključ
V zagonski fazi se ključi dodeljujejo na zahtevo. Dobite key_id in signing secret, vezana na vašo integracijo.
- 02
Podpišite zahtevo
Izračunajte HMAC-SHA256 skrivnosti nad timestamp.body, nato pošljite glave x-atlas-key-id, x-atlas-timestamp in x-atlas-signature. Okno za replay je 5 minut.
- 03
Pošljite konverzijo
Pošljite ref in externalOrderId ter bruto znesek v izvorni valuti in stanje. Atlas zaklene tečaj, izračuna provizijo in vrne uporabljeno stanje.
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" }Ena podpisana zahteva. Atlas odgovori z uporabljenim stanjem in izračunano provizijo.
Referenca payloada
Telo zahteve
JSON. ref in externalOrderId sta obvezna, ostalo je izbirno. Provizija, ki jo pošljete, se prezre: vir resnice je knjiga.
| Polje | Tip | Obvezno | Opis |
|---|---|---|---|
ref | string | Da | Identifikator atribucije v obliki partnerCode-shortCode. |
externalOrderId | string | Da | Vaša številka naročila. Na strani Atlasa deluje kot ključ idempotentnosti. |
amount | number | Ne | Bruto znesek prodaje v izvorni valuti. |
currency | string (3) | Ne | Oznaka ISO 4217. Neznana valuta se shrani kot needs_fx in se ovrednoti pozneje. |
status | enum | Ne | pending, validated ali cancelled. Privzeto je pending. |
subId | string | Ne | Podidentifikator kampanje ali vsebine za vaše poročanje. |
Kode odgovorov
Kaj API vrne
Jasne kode HTTP. Prepovedani prehodi stanj se nikoli ne uveljavijo tiho.
| Koda | Pomen |
|---|---|
200 | Konverzija zabeležena. action: inserted, updated, transitioned ali unchanged. |
400 | Manjkajoča polja, neveljaven ref ali ref, ki ne pripada lastniku povezave. |
401 | Neveljaven podpis, ključ ali timestamp (okno 5 minut). |
404 | Za ta ref ni najdene povezave. |
409 | Prepovedan prehod stanja: avtomat stanj ga zavrne. |
422 | Znesek nad varnostno mejo na konverzijo. |
Preverjanje pristnosti in varnost
Podpisano, omejeno, sledljivo
Vsak klicatelj ima svoj ključ in svojo skrivnost. Nič ni v skupni rabi, vse je preklicljivo.
Ključi na klicatelja
Ločen key_id in signing secret za vsako integracijo. Enega prekličete, drugih se ne dotaknete.
Podpis HMAC-SHA256
Podpis pokriva timestamp.body bajt za bajtom. Vsaka sprememba telesa razveljavi zahtevo.
Zaščita pred replayem
Zahteve, katerih timestamp odstopa za več kot 5 minut, so zavrnjene. Prestrežene zahteve ni mogoče ponoviti.
Idempotenten avtomat stanj
pending v validated ali cancelled; validated samo v cancelled; cancelled je dokončno. Ponovno pošiljanje istega stanja ne naredi ničesar.
Zanesljivost in podpora
Zgrajeno, da ostane v pogonu, odgovarjajo ljudje
Konverzijski API in sledene povezave tečejo na Cloudflareovem edge omrežju. Na to lahko računate glede razpoložljivosti, ponovitev in podpore.
99.9%
Ciljna razpoložljivost
Postbacki in sledene povezave tečejo na Cloudflare Workers s samodejnim preklopom. Nobena posamezna regija ne more podreti storitve.
300+
Edge lokacij
Zahteve postreže najbližja Cloudflare točka; provizija in pretvorba valute se izračunata pozneje, asinhrono, zunaj kritične poti vaše blagajne.
< 24h
Odzivni čas podpore
E-poštna podpora odgovori v enem delovnem dnevu. Vprašanja o integraciji pridejo do partnerske inženirske ekipe, ne v anonimno vrsto.
5 min
Varno okno za ponovitev
Idempotentno po externalOrderId: ponovite po vsaki časovni omejitvi brez dvojnega štetja, prestrežena zahteva pa je po petih minutah neuporabna.
Stran s stanjem je javna: preverjanje API v živo, k čemu se zavezujemo, in vsak incident od odprtja API. Vaš stik za integracijo in incidente ostaja partnerska ekipa, dosegljiva s kontaktne strani. Stanje API →
Agenti UI
Vaš agent pokliče orodje, HelloSafe vrne pravo ceno
Strežnik MCP izpostavlja izračun cene, primerjavo in preverjanje kartice kot tipizirana orodja. Dostop na zahtevo.
Strežnik MCP
Nobene integracije po zavarovalnici, nobene logike izračuna za pisanje, nobene regulativne inštalacije. Vaš kopilot, vaš klepetalni robot ali vaš rezervacijski tok pokliče orodje in dobi pravo ponudbo, z limiti in dokumenti. Povejte nam, kaj gradite.
Tehnična vprašanja
Kaj ekipe vprašajo pred integracijo.
Koliko stane API?
Nič. Ni pristopnine, mesečne naročnine na platformo ne stroška na klic pri konverzijskem API ali deep povezavah. Zaslužite 50 % provizij od prodaje, ki jo prinese vaša integracija; to je edini denarni tok v programu.
Ali obstaja REST API za cene?
Oba delujeta. Konverzijski API (postback) in REST API za cene: ustvarite račun, z enim klikom ustvarite sandbox ključ in zaprosite za produkcijski dostop, ko vaša integracija teče.
Kako deluje preverjanje pristnosti?
Podpisani ključi na klicatelja. Izračunate HMAC-SHA256 skrivnosti nad timestamp.body in ga pošljete v x-atlas-signature, z oknom za replay 5 minut. Starejša pot prek Bearer obstaja, dokler obstoječi klicatelji ne preidejo.
V kateri valuti naj pošljem znesek?
Bruto znesek v izvorni valuti, skupaj z oznako valute. Atlas ob prejemu zaklene tečaj, pretvori v evre (računovodska valuta) in izračuna provizijo po vaši stopnji. Provizija, ki jo pošljete, se prezre.
Ali je postback idempotenten?
Da. Ključ je externalOrderId: ponovno pošiljanje istega stanja ne naredi ničesar, avtomat stanj pa prepovedane prehode zavrne s kodo 409, namesto da bi jih tiho uveljavil.
Ali se lahko povežem prek Impact, Partnerize ali Awin?
Da. Ponujamo standardni S2S postback, ki se neposredno poveže z Impact, Partnerize, Awin, Voluum, RedTrack in Everflow. Konverzije lahko pošiljate tudi na lasten BI webhook ali jih izvozite v CSV.
Ali imate specifikacijo OpenAPI?
Da, javno in brez prijave. Referenčna stran se iz te specifikacije generira ob vsaki gradnji, zato se dokumentacija in pogodba ne moreta razhajati.
Ali podpirate MCP?
V zaprti beti. Strežnik MCP izpostavlja izračun cene, primerjavo in sklenitev kot tipizirana orodja, ki jih lahko pokliče vaš LLM ali agent.
Na kakšno razpoložljivost in podporo lahko računam?
Konverzijski API in sledene povezave tečejo na Cloudflare Workers s samodejnim preklopom; ciljamo na 99,9 % razpoložljivosti. E-poštna podpora odgovori v enem delovnem dnevu, vprašanja o integraciji pa pridejo do partnerske inženirske ekipe. Stran s stanjem je javna.
Ali Coach potrebuje drug ključ?
Ne. En ključ odpira celoten API: cene, sledene povezave in Coach. Isti podpis, isti števec, iste kvote.
Tehnično ali poslovno vprašanje? Kontaktirajte nas
Gradimo
Dodajte potovalno zavarovanje v svoj izdelek
Ustvarite račun in z enim klikom ustvarite sandbox ključ: fiksni vzorčni podatki, nobena zavarovalnica ni poklicana, ničesar ni treba podpisati. Produkcijski dostop je kratek pregled, ko vaša integracija teče.