HelloSafe

Koja je vaša država prebivališta?

Platforma za razvojne inženjere

API za prodaju putnog osiguranja unutar vašeg proizvoda

Potpisani konverzijski API, praćene deep poveznice i S2S postback u vaš stack. Besplatno za integraciju i besplatno po pozivu: plaćeni ste kroz proviziju.

Besplatan sandbox ključ Pogledajte konverzijski API

Što stoji iza API-ja

Katalog

50

Putnika po ponudi

Možete izračunati cijenu za 1 do 50 osoba u jednom pozivu. Iznad deset putnika preuzima grupni proizvod: ista cijena po osobi, bez obzira na dob.

193

Zemalja prebivališta

Putnik dobiva cijenu bez obzira na to iz koje zemlje kreće.

193

Odredišta

Sva odredišta, uključujući rizična područja.

26

Jezika

Tijek, dokumenti i sažetak na jeziku putnika.

33

Valuta

Cijena se prikazuje u valuti putnika.

28

Pokrića

Zdravlje, asistencija, putovanje, prtljaga, odgovornost, aktivnosti, expat. Limiti i franšize u odgovoru.

Što ne morate graditi

Tri stvari koje nikada nećete graditi

Nikakva vlastita licenca

HelloSafe je registrirani distributer i nosi usklađenost. Vi ugrađujete iskustvo, ne regulativu.

Nikakva integracija po osiguravatelju

Jedan poziv, cijeli katalog. Veze, izmjene proizvoda i ugovorni dokumenti ostaju kod nas.

Nikakav prodavač za nazvati

Sandbox ključ je jedan klik od vašeg računa. Bez provjere, bez kartice, bez sastanka.

Putovi integracije

Pet načina za spajanje HelloSafea

Od praćene poveznice postavljene u jedno popodne do REST API-ja za izračun cijene: odaberite razinu integracije. Isto pokriće, iste provizije.

U radu

Praćene deep poveznice

Jedna praćena poveznica po sadržaju ili kampanji, sa Sub-ID-om. Najbrži početak, bez koda.

  • Deep poveznice po stranici i po ponudi
  • Sub-ID po kampanji, sadržaju ili prodajnom mjestu
  • Kolačić atribucije na 90 dana, last-click
U radu

API konverzijskog postbacka

Javite Atlasu kada pripisana prodaja stigne ili promijeni stanje. Zahtjev potpisan HMAC-om, stroj stanja, idempotentno.

  • Potpisani ključevi po pozivatelju (HMAC-SHA256)
  • Stanja: pending, validated, cancelled
  • Iznos u izvornoj valuti: proviziju računa poslužitelj
U radu

S2S postback u vaš stack

Šaljite konverzije tamo gdje vodite posao: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow ili webhook prema BI-ju.

  • Standardni S2S konektori
  • Webhook prema vašem BI-ju
  • CSV izvoz
U radu

REST API za cijene

Izračunajte cijenu putovanja kod više osiguravatelja, stvorite praćenu prodajnu poveznicu i pročitajte što kartica putnika ne pokriva. Jedan ključ za sve. Otvorite račun i sandbox ključ je na jedan klik.

  • Ponude više osiguravatelja u stvarnom vremenu
  • Praćena prodajna poveznica s ugrađenom atribucijom
  • Javna dokumentacija i OpenAPI specifikacija
Privatna beta

MCP poslužitelj za AI agente

Tipizirani alati kako bi vaš LLM ili agent mogao tražiti, uspoređivati i sklapati, na temelju stvarnih podataka.

  • Tipizirani alati za Claude, ChatGPT i vlastite agente
  • Odgovori utemeljeni na stvarnim podacima
  • Agentski checkout

Dokumentacija

Pročitajte prije nego što gradite

Dokumentacija je javna i na engleskom. Bez prijave, bez obrasca: sve što API vraća je zapisano.

Brzi početak

Sandbox ključ, potpisani zahtjev, prve ponude s cijenom. Node, cURL i PHP.

Brzi početak →

Referenca API-ja

Endpointi, polja putovanja, oznake pokrića, kodovi grešaka i kvote.

Referenca API-ja →

OpenAPI specifikacija

Strojno čitljiv ugovor, za vaš generator klijenta.

OpenAPI specifikacija →

Status API-ja

Provjera API-ja uživo, obveze dostupnosti i zapisnik incidenata.

Status API-ja →

Konverzijski API konkretno

Od postbacka do provizije, u jednom potpisanom zahtjevu

Konverzijski API radi već danas. Pošaljete pripisanu prodaju, Atlas je poveže s poveznicom, pretvori u eure i izračuna proviziju prema vašoj stopi.

  1. 01

    Nabavite ključ

    U fazi pokretanja ključevi se dodjeljuju na zahtjev. Dobivate key_id i signing secret vezane uz vašu integraciju.

  2. 02

    Potpišite zahtjev

    Izračunajte HMAC-SHA256 tajne nad timestamp.body, zatim pošaljite zaglavlja x-atlas-key-id, x-atlas-timestamp i x-atlas-signature. Prozor za replay je 5 minuta.

  3. 03

    Pošaljite konverziju

    Pošaljite ref i externalOrderId, uz bruto iznos u izvornoj valuti i stanje. Atlas zaključa tečaj, izračuna proviziju i vrati primijenjeno 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" }

Jedan potpisani zahtjev. Atlas odgovara primijenjenim stanjem i izračunatom provizijom.

Referenca payloada

Tijelo zahtjeva

JSON. ref i externalOrderId su obavezni, ostalo je neobavezno. Provizija koju pošaljete se zanemaruje: knjiga je izvor istine.

Polje Tip Obavezno Opis
ref string Da Identifikator atribucije, u formatu partnerCode-shortCode.
externalOrderId string Da Vaš broj narudžbe. Na strani Atlasa služi kao ključ idempotencije.
amount number Ne Bruto iznos prodaje, u izvornoj valuti.
currency string (3) Ne ISO 4217 oznaka. Nepoznata valuta sprema se kao needs_fx i naknadno se preračuna.
status enum Ne pending, validated ili cancelled. Zadano je pending.
subId string Ne Podidentifikator kampanje ili sadržaja, za vaše izvještavanje.

Kodovi odgovora

Što API vraća

Jasni HTTP kodovi. Zabranjeni prijelazi stanja nikada se ne primjenjuju u tišini.

Kod Značenje
200 Konverzija zabilježena. action: inserted, updated, transitioned ili unchanged.
400 Nedostajuća polja, neispravan ref ili ref koji ne pripada vlasniku poveznice.
401 Neispravan potpis, ključ ili timestamp (prozor od 5 minuta).
404 Nije pronađena poveznica za ovaj ref.
409 Zabranjen prijelaz stanja: stroj stanja ga odbija.
422 Iznos iznad sigurnosne granice po konverziji.

Autentikacija i sigurnost

Potpisano, ograničeno, provjerljivo

Svaki pozivatelj ima vlastiti ključ i vlastitu tajnu. Ništa se ne dijeli, sve se može opozvati.

Ključevi po pozivatelju

Zaseban key_id i signing secret za svaku integraciju. Opozovite jedan bez diranja ostalih.

HMAC-SHA256 potpis

Potpis pokriva timestamp.body bajt po bajt. Svaka promjena tijela poništava zahtjev.

Zaštita od replaya

Zahtjevi čiji timestamp odstupa više od 5 minuta se odbijaju. Presretnuti zahtjev nije moguće ponoviti.

Idempotentan stroj stanja

pending u validated ili cancelled; validated samo u cancelled; cancelled je konačno. Ponovno slanje istog stanja ne mijenja ništa.

Pouzdanost i podrška

Građeno da ostane u pogonu, odgovaraju ljudi

Konverzijski API i praćene poveznice rade na Cloudflareovoj edge mreži. Evo na što možete računati po dostupnosti, ponovnim pokušajima i podršci.

99.9%

Ciljana dostupnost

Postbackovi i praćene poveznice rade na Cloudflare Workersu s automatskim prebacivanjem. Nijedna pojedinačna regija ne može srušiti uslugu.

300+

Edge lokacija

Zahtjeve poslužuje najbliža Cloudflare točka; provizija i pretvorba valute računaju se poslije, asinkrono, izvan kritične putanje vaše naplate.

< 24h

Vrijeme odgovora podrške

Podrška e-poštom odgovara unutar jednog radnog dana. Pitanja o integraciji stižu inženjerskom timu za partnere, ne u anonimni red.

5 min

Sigurni prozor za ponavljanje

Idempotentno po externalOrderId: ponovite nakon svakog isteka vremena bez dvostrukog brojanja, a presretnuti zahtjev nakon pet minuta je neupotrebljiv.

Stranica statusa je javna: provjera API-ja uživo, na što se obvezujemo i svaki incident od otvaranja API-ja. Vaš kontakt za integraciju i incidente ostaje partnerski tim, dostupan sa stranice za kontakt. Status API-ja →

AI agenti

Vaš agent pozove alat, HelloSafe vrati pravu cijenu

MCP poslužitelj izlaže izračun cijene, usporedbu i provjeru kartice kao tipizirane alate. Pristup na zahtjev.

Na zahtjev

MCP poslužitelj

Nikakva integracija po osiguravatelju, nikakva logika izračuna za pisati, nikakva regulatorna instalacija. Vaš kopilot, vaš chatbot ili vaš tok rezervacije pozove alat i dobije pravu ponudu, s limitima i dokumentima. Javite nam što gradite.

Tehnička pitanja

Što timovi pitaju prije integracije.

Koliko košta API?

Ništa. Nema naknade za postavljanje, mjesečne naknade za platformu ni troška po pozivu na konverzijskom API-ju ili deep poveznicama. Zarađujete 50 % provizija na prodaji koju donese vaša integracija; to je jedini novčani tok u programu.

Postoji li REST API za cijene?

Oba rade. Konverzijski API (postback) i REST API za cijene: otvorite račun, stvorite sandbox ključ jednim klikom i zatražite produkcijski pristup kad vam integracija proradi.

Kako radi autentikacija?

Potpisani ključevi po pozivatelju. Izračunate HMAC-SHA256 tajne nad timestamp.body i pošaljete ga u x-atlas-signature, s prozorom za replay od 5 minuta. Stariji Bearer put postoji dok postojeći pozivatelji migriraju.

U kojoj valuti šaljem iznos?

Bruto iznos u izvornoj valuti, zajedno s oznakom valute. Atlas zaključa tečaj pri zaprimanju, pretvori u eure (računovodstvena valuta) i izračuna proviziju prema vašoj stopi. Provizija koju pošaljete se zanemaruje.

Je li postback idempotentan?

Da. Ključ je externalOrderId: ponovno slanje istog stanja ne mijenja ništa, a stroj stanja odbija zabranjene prijelaze kodom 409 umjesto da ih tiho primijeni.

Mogu li se integrirati preko Impacta, Partnerizea ili Awina?

Da. Nudimo standardni S2S postback koji se izravno spaja na Impact, Partnerize, Awin, Voluum, RedTrack i Everflow. Konverzije možete slati i na vlastiti BI webhook ili izvesti u CSV.

Imate li OpenAPI specifikaciju?

Da, javnu i bez prijave. Referentna stranica generira se iz te specifikacije pri svakom buildu, pa dokumentacija i ugovor ne mogu razići.

Podržavate li MCP?

U privatnoj beti. MCP poslužitelj izlaže izračun cijene, usporedbu i sklapanje kao tipizirane alate koje vaš LLM ili agent može pozvati.

Na kakvu dostupnost i podršku mogu računati?

Konverzijski API i praćene poveznice rade na Cloudflare Workersu s automatskim prebacivanjem; ciljamo 99,9 % dostupnosti. Podrška e-poštom odgovara unutar jednog radnog dana, a pitanja o integraciji stižu inženjerskom timu za partnere. Stranica statusa je javna.

Treba li Coach drugi ključ?

Ne. Jedan ključ otvara cijeli API: cijene, praćene poveznice i Coach. Isti potpis, isti brojač, iste kvote.

Tehničko ili poslovno pitanje? Kontaktirajte nas

Gradimo

Dodajte putno osiguranje u svoj proizvod

Otvorite račun i stvorite sandbox ključ jednim klikom: fiksni ogledni podaci, nijedan osiguravatelj se ne poziva, ništa se ne potpisuje. Produkcijski pristup je kratka provjera kad vam integracija proradi.

Besplatan sandbox ključ Pročitajte česta pitanja