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.
Platforma za razvojne inženjere
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.
Što stoji iza API-ja
50
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
Putnik dobiva cijenu bez obzira na to iz koje zemlje kreće.
193
Sva odredišta, uključujući rizična područja.
26
Tijek, dokumenti i sažetak na jeziku putnika.
33
Cijena se prikazuje u valuti putnika.
28
Zdravlje, asistencija, putovanje, prtljaga, odgovornost, aktivnosti, expat. Limiti i franšize u odgovoru.
Što ne morate graditi
HelloSafe je registrirani distributer i nosi usklađenost. Vi ugrađujete iskustvo, ne regulativu.
Jedan poziv, cijeli katalog. Veze, izmjene proizvoda i ugovorni dokumenti ostaju kod nas.
Sandbox ključ je jedan klik od vašeg računa. Bez provjere, bez kartice, bez sastanka.
Putovi integracije
Od praćene poveznice postavljene u jedno popodne do REST API-ja za izračun cijene: odaberite razinu integracije. Isto pokriće, iste provizije.
Jedna praćena poveznica po sadržaju ili kampanji, sa Sub-ID-om. Najbrži početak, bez koda.
Javite platformi Atlas kada pripisana prodaja stigne ili promijeni stanje. Zahtjev potpisan HMAC-om, stroj stanja, idempotentno.
Šaljite konverzije tamo gdje vodite posao: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow ili webhook prema BI-ju.
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.
Tipizirani alati koje poziva vaš LLM: pretraga, usporedba, slanje praćene poveznice. U privatnoj beta verziji.
Dokumentacija
Dokumentacija je javna i na engleskom. Bez prijave, bez obrasca: sve što API vraća je zapisano.
Sandbox ključ, potpisani zahtjev, prve ponude s cijenom. Node, cURL i PHP.
Brzi početak →Endpointi, polja putovanja, oznake pokrića, kodovi grešaka i kvote.
Referenca API-ja →Strojno čitljiv ugovor, za vaš generator klijenta.
OpenAPI specifikacija →Provjera API-ja uživo, obveze dostupnosti i zapisnik incidenata.
Status API-ja →Konverzijski API konkretno
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.
U fazi pokretanja ključevi se dodjeljuju na zahtjev. Dobivate key_id i signing secret vezane uz vašu integraciju.
Izračunajte HMAC-SHA256 tajne nad timestamp.body, zatim pošaljite zaglavlja x-atlas-key-id, x-atlas-timestamp i x-atlas-signature. Zaštitni prozor protiv replaya je 5 minuta.
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.
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
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 platforme Atlas 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
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. |
Autentifikacija i sigurnost
Svaki pozivatelj ima vlastiti ključ i vlastitu tajnu. Ništa se ne dijeli, sve se može opozvati.
Zaseban key_id i signing secret za svaku integraciju. Opozovite jedan bez diranja ostalih.
Potpis pokriva timestamp.body bajt po bajt. Svaka promjena tijela poništava zahtjev.
Zahtjevi čiji timestamp odstupa više od 5 minuta se odbijaju. Presretnuti zahtjev nije moguće ponoviti.
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
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 %
Postbackovi i praćene poveznice rade na Cloudflare Workersu s automatskim prebacivanjem. Nijedna pojedinačna regija ne može srušiti uslugu.
300+
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
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
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
MCP poslužitelj izlaže izračun cijene, usporedbu i provjeru kartice kao tipizirane alate. Pristup na zahtjev.
Nikakva integracija po osiguravatelju, nikakvo pisanje logike izračuna, 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.
Što timovi pitaju prije integracije.
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.
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.
Potpisani ključevi po pozivatelju. Izračunate HMAC-SHA256 tajne nad timestamp.body i pošaljete ga u x-atlas-signature, sa zaštitnim prozorom od 5 minuta protiv replaya. Stariji Bearer put postoji dok postojeći pozivatelji migriraju.
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.
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.
Putem webhooka za prodaju. Upišite adresu svojeg poslužitelja na dashboardu: svaka prodaja šalje vam se u stvarnom vremenu, potpisana, a drugi put ako se otkaže ili refundira. Gumb šalje testnu prodaju, a da ništa ne kupujete. Prodaje možete i pročitati poveznicu po poveznicu putem GET /api/v1/travel/sales te proslijediti vlastiti ID klika (na primjer Google Ads gclid) kako biste ga primili uz svaku prodaju. Osobni podaci putnika ne šalju se.
Da. Nudimo standardni S2S postback koji se izravno spaja na Impact, Partnerize, Awin, Voluum, RedTrack i Everflow, ili webhook prema vašem BI-ju.
Da, objavljena na /openapi.json, u formatu OpenAPI 3.1, s potpunom referencom na /platform/api/documentation. Konverzijski API dokumentiran je gore navedenim ugovorom: endpoint, potpisana zaglavlja, sadržaj zahtjeva i kodovi odgovora.
U privatnoj beti. MCP poslužitelj izlaže izračun cijene, usporedbu i ugovaranje kao tipizirane alate koje vaš LLM ili agent može pozvati.
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. Javna stranica statusa je u pripremi.
Ne. Jedan ključ otvara cijeli API: cijene, praćene poveznice i Coach analizu. Testni ključ generiran s dashboarda nosi sva tri opsega, pa cijeli API možete isprobati bez razgovora s ikim.
Tehničko ili poslovno pitanje? Kontaktirajte nas
Gradimo
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.