50
Keliautojų viename pasiūlyme
Viena užklausa galite įkainoti nuo 1 iki 50 žmonių. Virš dešimties keliautojų perima grupinis produktas: ta pati kaina vienam žmogui, nepriklausomai nuo amžiaus.
Kūrėjų platforma
API kelionių draudimui parduoti jūsų produkto viduje
Pasirašytas konversijų API, sekamos gilios nuorodos ir S2S postback į jūsų steką. Nemokama integruoti ir nemokama už užklausą: jums mokamas komisinis.
Kas slypi už API
Katalogas
193
Gyvenamosios šalys
Keliautojas gauna kainą, iš kurios šalies bevyktų.
193
Kryptys
Visos kryptys, įskaitant rizikos zonas.
26
Kalbos
Eiga, dokumentai ir santrauka keliautojo kalba.
33
Valiutos
Kaina rodoma keliautojo valiuta.
28
Draudimai
Sveikata, pagalba, kelionė, bagažas, atsakomybė, veiklos, expat. Limitai ir išskaitos atsakyme.
Ko jums nereikia kurti
Trys dalykai, kurių niekada nekursite
Jokios savo licencijos
HelloSafe yra registruotas platintojas ir prisiima atitiktį. Jūs įdiegiate patirtį, o ne reguliavimą.
Jokios integracijos su kiekvienu draudiku
Vienas iškvietimas, visas katalogas. Jungtys, produktų pakeitimai ir sutarties dokumentai lieka pas mus.
Jokio pardavėjo, kuriam reikia skambinti
Sandbox raktas yra per vieną paspaudimą nuo jūsų paskyros. Be peržiūros, be kortelės, be susitikimo.
Integracijos keliai
Penki būdai prijungti HelloSafe
Nuo sekamos nuorodos, įdiegtos per popietę, iki įkainojimo REST API: pasirinkite integracijos lygį. Ta pati apsauga, tie patys komisiniai.
Sekamos gilios nuorodos
Viena sekama nuoroda kiekvienam turiniui ar kampanijai, su Sub-ID. Greičiausia pradžia, be kodo.
- Gilios nuorodos pagal puslapį ir pasiūlymą
- Sub-ID pagal kampaniją, turinį ar pardavimo tašką
- 90 dienų priskyrimo slapukas, last-click
Konversijų postback API
Praneškite Atlas, kai priskirtas pardavimas įvyksta arba keičia būseną. HMAC pasirašyta užklausa, būsenų automatas, idempotentiška.
- Pasirašyti raktai kiekvienam skambintojui (HMAC-SHA256)
- Būsenos: pending, validated, cancelled
- Suma sava valiuta: komisinį skaičiuoja serveris
S2S postback į jūsų steką
Siųskite konversijas ten, kur valdote verslą: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow arba BI webhook.
- Standartinės S2S jungtys
- Webhook į jūsų BI
- CSV eksportas
Įkainojimo REST API
Įkainokite kelionę pas kelis draudikus, sukurkite sekamą pardavimo nuorodą ir sužinokite, ko keliautojo kortelė nepadengia. Vienas raktas viskam. Susikurkite paskyrą ir sandbox raktas bus per vieną paspaudimą.
- Kelių draudikų pasiūlymai realiu laiku
- Sekama pardavimo nuoroda su įmontuotu priskyrimu
- Vieša dokumentacija ir OpenAPI specifikacija
MCP serveris AI agentams
Tipizuoti įrankiai, kad jūsų LLM ar agentas galėtų ieškoti, lyginti ir sudaryti sutartį, remdamasis realiais duomenimis.
- Tipizuoti įrankiai Claude, ChatGPT ir saviems agentams
- Atsakymai, paremti tikrais duomenimis
- Agentinis checkout
Dokumentacija
Perskaitykite prieš kurdami
Dokumentacija yra vieša ir anglų kalba. Be prisijungimo, be formos: viskas, ką API grąžina, yra užrašyta.
Greita pradžia
Sandbox raktas, pasirašyta užklausa, pirmieji įkainoti pasiūlymai. Node, cURL ir PHP.
Greita pradžia →API žinynas
Galiniai taškai, kelionės laukai, draudimo kodai, klaidų kodai ir kvotos.
API žinynas →OpenAPI specifikacija
Mašininiu būdu skaitoma sutartis jūsų kliento generatoriui.
OpenAPI specifikacija →API būsena
API patikra realiu laiku, pasiekiamumo įsipareigojimai ir incidentų žurnalas.
API būsena →Konversijų API praktikoje
Nuo postback iki komisinio viena pasirašyta užklausa
Konversijų API veikia jau šiandien. Jūs išsiunčiate priskirtą pardavimą, Atlas susieja jį su nuoroda, konvertuoja į eurus ir apskaičiuoja komisinį pagal jūsų tarifą.
- 01
Gaukite raktą
Paleidimo etape raktai išduodami pagal prašymą. Gaunate key_id ir signing secret, galiojančius tik jūsų integracijai.
- 02
Pasirašykite užklausą
Apskaičiuokite paslapties HMAC-SHA256 per timestamp.body ir siųskite antraštes x-atlas-key-id, x-atlas-timestamp bei x-atlas-signature. Replay langas yra 5 minutės.
- 03
Išsiųskite konversiją
Siųskite ref ir externalOrderId bei bruto sumą jos valiuta ir būseną. Atlas užfiksuoja kursą, apskaičiuoja komisinį ir grąžina pritaikytą būseną.
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" }Viena pasirašyta užklausa. Atlas atsako pritaikyta būsena ir apskaičiuotu komisiniu.
Payload žinynas
Užklausos turinys
JSON. ref ir externalOrderId yra privalomi, kita neprivaloma. Atsiųstas komisinis ignoruojamas: tiesos šaltinis yra didžioji knyga.
| Laukas | Tipas | Privaloma | Aprašymas |
|---|---|---|---|
ref | string | Taip | Priskyrimo identifikatorius formatu partnerCode-shortCode. |
externalOrderId | string | Taip | Jūsų užsakymo numeris. Atlas pusėje veikia kaip idempotencijos raktas. |
amount | number | Ne | Bruto pardavimo suma jos valiuta. |
currency | string (3) | Ne | ISO 4217 kodas. Nežinoma valiuta saugoma kaip needs_fx ir įkainojama vėliau. |
status | enum | Ne | pending, validated arba cancelled. Numatytoji reikšmė pending. |
subId | string | Ne | Kampanijos ar turinio poidentifikatorius jūsų ataskaitoms. |
Atsakymo kodai
Ką API grąžina
Aiškūs HTTP kodai. Draudžiami būsenų perėjimai niekada netaikomi tyliai.
| Kodas | Reikšmė |
|---|---|
200 | Konversija užfiksuota. action: inserted, updated, transitioned arba unchanged. |
400 | Trūksta laukų, netinkamas ref arba ref, nepriklausantis nuorodos savininkui. |
401 | Netinkamas parašas, raktas arba timestamp (5 minučių langas). |
404 | Šiam ref nerasta jokia nuoroda. |
409 | Draudžiamas būsenos perėjimas: būsenų automatas jį atmeta. |
422 | Suma viršija saugos ribą vienai konversijai. |
Autentifikacija ir sauga
Pasirašyta, apribota, patikrinama
Kiekvienas skambintojas turi savo raktą ir savo paslaptį. Niekas nesidalijama, viską galima atšaukti.
Raktai kiekvienam skambintojui
Atskiras key_id ir signing secret kiekvienai integracijai. Vieną atšaukiate neliesdami kitų.
HMAC-SHA256 parašas
Parašas apima timestamp.body baitas po baito. Bet koks turinio pakeitimas panaikina užklausos galiojimą.
Apsauga nuo replay
Užklausos, kurių timestamp skiriasi daugiau nei 5 minutėmis, atmetamos. Perimtos užklausos pakartoti negalima.
Idempotentiškas būsenų automatas
pending į validated arba cancelled; validated tik į cancelled; cancelled yra galutinė. Tos pačios būsenos pakartotinis siuntimas nieko nekeičia.
Patikimumas ir pagalba
Sukurta veikti, atsako žmonės
Konversijų API ir sekamos nuorodos veikia Cloudflare edge tinkle. Štai kuo galite remtis dėl pasiekiamumo, pakartojimų ir pagalbos.
99.9%
Siekiamas pasiekiamumas
Postback ir sekamos nuorodos veikia Cloudflare Workers su automatiniu perjungimu. Nė vienas regionas vienas negali nuversti paslaugos.
300+
Edge vietų
Užklausas aptarnauja artimiausias Cloudflare taškas; komisinis ir valiutos keitimas skaičiuojami po to, asinchroniškai, už jūsų atsiskaitymo kritinio kelio ribų.
< 24h
Pagalbos atsako laikas
El. pašto pagalba atsako per vieną darbo dieną. Integracijos klausimai pasiekia partnerių inžinierių komandą, o ne anoniminę eilę.
5 min
Saugus pakartojimo langas
Idempotentiška pagal externalOrderId: kartokite po bet kokio laiko limito be dvigubo skaičiavimo, o perimta užklausa po penkių minučių yra netinkama.
Būsenos puslapis yra viešas: API patikra realiu laiku, ką įsipareigojame, ir kiekvienas incidentas nuo API atidarymo. Jūsų kontaktas dėl integracijos ir incidentų lieka partnerių komanda, pasiekiama iš kontaktų puslapio. API būsena →
AI agentai
Jūsų agentas iškviečia įrankį, HelloSafe grąžina tikrą kainą
MCP serveris pateikia įkainojimą, palyginimą ir kortelės patikrą kaip tipizuotus įrankius. Prieiga pagal pageidavimą.
MCP serveris
Jokios integracijos su kiekvienu draudiku, jokios įkainojimo logikos, kurią reikia rašyti, jokios reguliavimo santechnikos. Jūsų kopilotas, pokalbių robotas arba rezervacijos srautas iškviečia įrankį ir gauna tikrą pasiūlymą su limitais ir dokumentais. Parašykite, ką kuriate.
Techniniai klausimai
Ko komandos klausia prieš integraciją.
Kiek kainuoja API?
Nieko. Nėra nei įdiegimo mokesčio, nei mėnesinio platformos mokesčio, nei mokesčio už užklausą konversijų API ar giliose nuorodose. Uždirbate 50 % komisinių nuo pardavimų, kuriuos atneša jūsų integracija; tai vienintelis pinigų srautas programoje.
Ar yra REST API įkainojimui?
Abu veikia. Konversijų API (postback) ir įkainojimo REST API: susikurkite paskyrą, vienu paspaudimu sukurkite sandbox raktą ir prašykite produkcinės prieigos, kai integracija veikia.
Kaip veikia autentifikacija?
Pasirašyti raktai kiekvienam skambintojui. Apskaičiuojate paslapties HMAC-SHA256 per timestamp.body ir siunčiate jį antraštėje x-atlas-signature, su 5 minučių replay langu. Senesnis Bearer kelias veikia, kol esami skambintojai migruoja.
Kokia valiuta siųsti sumą?
Bruto sumą jos valiuta kartu su valiutos kodu. Atlas užfiksuoja kursą gavimo metu, konvertuoja į eurus (apskaitos valiuta) ir apskaičiuoja komisinį pagal jūsų tarifą. Atsiųstas komisinis ignoruojamas.
Ar postback yra idempotentiškas?
Taip. Raktas yra externalOrderId: tos pačios būsenos pakartotinis siuntimas nieko nekeičia, o būsenų automatas atmeta draudžiamus perėjimus su 409, užuot tyliai juos pritaikęs.
Ar galiu integruotis per Impact, Partnerize ar Awin?
Taip. Siūlome standartinį S2S postback, kuris tiesiogiai jungiasi prie Impact, Partnerize, Awin, Voluum, RedTrack ir Everflow. Konversijas taip pat galite siųsti į savo BI webhook arba eksportuoti į CSV.
Ar turite OpenAPI specifikaciją?
Taip, viešą ir be prisijungimo. Žinyno puslapis generuojamas iš tos specifikacijos kiekvieno kūrimo metu, todėl dokumentacija ir sutartis negali išsiskirti.
Ar palaikote MCP?
Privačioje betoje. MCP serveris pateikia įkainojimą, palyginimą ir sutarties sudarymą kaip tipizuotus įrankius, kuriuos gali kviesti jūsų LLM ar agentas.
Kokio pasiekiamumo ir pagalbos galiu tikėtis?
Konversijų API ir sekamos nuorodos veikia Cloudflare Workers su automatiniu perjungimu; siekiame 99,9 % pasiekiamumo. El. pašto pagalba atsako per vieną darbo dieną, o integracijos klausimai pasiekia partnerių inžinierių komandą. Būsenos puslapis yra viešas.
Ar Coach reikia antro rakto?
Ne. Vienas raktas atveria visą API: įkainojimą, sekamas nuorodas ir Coach. Tas pats parašas, tas pats skaitiklis, tos pačios kvotos.
Techninis ar komercinis klausimas? Susisiekite su mumis
Kurkime
Pridėkite kelionių draudimą prie savo produkto
Susikurkite paskyrą ir vienu paspaudimu sukurkite sandbox raktą: fiksuoti pavyzdiniai duomenys, joks draudikas nekviečiamas, nieko nereikia pasirašyti. Produkcinė prieiga yra trumpa peržiūra, kai integracija veikia.