50
Ceļotāju vienā piedāvājumā
Vienā izsaukumā varat aprēķināt cenu no 1 līdz 50 personām. Virs desmit ceļotājiem pārņem grupas produkts: viena cena par personu neatkarīgi no vecuma.
Izstrādātāju platforma
API ceļojumu apdrošināšanas pārdošanai jūsu produkta iekšienē
Parakstīts konversijas API, izsekojamas dziļās saites un S2S postback uz jūsu steku. Bez maksas integrācijai un bez maksas par izsaukumu: jums maksā komisiju.
Kas ir aiz API
Katalogs
193
Dzīvesvietas valstis
Ceļotājs saņem cenu neatkarīgi no tā, no kuras valsts viņš dodas ceļā.
193
Galamērķi
Visi galamērķi, ieskaitot riska zonas.
26
Valodas
Process, dokumenti un kopsavilkums ceļotāja valodā.
33
Valūtas
Cena tiek rādīta ceļotāja valūtā.
28
Segumi
Veselība, palīdzība, ceļojums, bagāža, atbildība, aktivitātes, expat. Limiti un pašriski atbildē.
Kas jums nav jābūvē
Trīs lietas, ko jūs nekad nebūvēsiet
Nekādas savas licences
HelloSafe ir reģistrētais izplatītājs un uzņemas atbilstību. Jūs iebūvējat pieredzi, nevis regulējumu.
Nekādas integrācijas uz apdrošinātāju
Viens izsaukums, viss katalogs. Savienojumi, produktu izmaiņas un līguma dokumenti paliek pie mums.
Neviena pārdevēja, kam zvanīt
Sandbox atslēga ir viena klikšķa attālumā no jūsu konta. Bez izskatīšanas, bez kartes, bez tikšanās.
Integrācijas ceļi
Pieci veidi, kā pieslēgt HelloSafe
No izsekojamas saites, kas uzstādīta vienā pēcpusdienā, līdz cenu REST API: izvēlieties integrācijas līmeni. Tas pats segums, tās pašas komisijas.
Izsekojamas dziļās saites
Viena izsekojama saite katram saturam vai kampaņai, ar Sub-ID. Ātrākais sākums, bez koda.
- Dziļās saites pa lapām un piedāvājumiem
- Sub-ID pa kampaņām, saturu vai tirdzniecības vietām
- 90 dienu attiecinājuma sīkdatne, last-click
Konversijas postback API
Paziņojiet Atlas, kad attiecinātais pārdevums pienāk vai maina statusu. Ar HMAC parakstīts pieprasījums, stāvokļu mašīna, idempotents.
- Parakstītas atslēgas katram izsaucējam (HMAC-SHA256)
- Statusi: pending, validated, cancelled
- Summa savā valūtā: komisiju aprēķina serveris
S2S postback uz jūsu steku
Sūtiet konversijas turp, kur vadāt biznesu: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow vai BI webhook.
- Standarta S2S savienotāji
- Webhook uz jūsu BI
- CSV eksports
Cenu REST API
Aprēķiniet ceļojuma cenu vairākos apdrošinātājos, izveidojiet izsekojamo pārdošanas saiti un uzziniet, ko ceļotāja karte nesedz. Viena atslēga visam. Izveidojiet kontu, un sandbox atslēga ir viena klikšķa attālumā.
- Reāllaika piedāvājumi no vairākiem apdrošinātājiem
- Izsekojama pārdošanas saite ar iebūvētu attiecinājumu
- Publiska dokumentācija un OpenAPI specifikācija
MCP serveris AI aģentiem
Tipizēti rīki, lai jūsu LLM vai aģents varētu meklēt, salīdzināt un noslēgt, balstoties uz reāliem datiem.
- Tipizēti rīki Claude, ChatGPT un pašu aģentiem
- Atbildes, kas balstās uz reāliem datiem
- Aģentu checkout
Dokumentācija
Izlasiet, pirms sākat būvēt
Dokumentācija ir publiska un angļu valodā. Bez pieteikšanās, bez veidlapas: viss, ko API atbild, ir pierakstīts.
Ātrais sākums
Sandbox atslēga, parakstīts pieprasījums, pirmie cenotie piedāvājumi. Node, cURL un PHP.
Ātrais sākums →API atsauce
Galapunkti, ceļojuma lauki, seguma kodi, kļūdu kodi un kvotas.
API atsauce →OpenAPI specifikācija
Mašīnlasāms līgums jūsu klienta ģeneratoram.
OpenAPI specifikācija →API statuss
API pārbaude tiešraidē, pieejamības saistības un incidentu žurnāls.
API statuss →Konversijas API praksē
No postback līdz komisijai vienā parakstītā pieprasījumā
Konversijas API darbojas jau šodien. Jūs nosūtāt attiecināto pārdevumu, Atlas sasaista to ar saiti, pārrēķina eiro un aprēķina komisiju pēc jūsu likmes.
- 01
Saņemiet atslēgu
Palaišanas posmā atslēgas izsniedz pēc pieprasījuma. Jūs saņemat key_id un signing secret, kas attiecas tikai uz jūsu integrāciju.
- 02
Parakstiet pieprasījumu
Aprēķiniet noslēpuma HMAC-SHA256 pār timestamp.body un nosūtiet galvenes x-atlas-key-id, x-atlas-timestamp un x-atlas-signature. Replay logs ir 5 minūtes.
- 03
Nosūtiet konversiju
Nosūtiet ref un externalOrderId, kā arī bruto summu tās valūtā un statusu. Atlas fiksē kursu, aprēķina komisiju un atgriež piemēroto statusu.
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" }Viens parakstīts pieprasījums. Atlas atbild ar piemēroto statusu un aprēķināto komisiju.
Payload atsauce
Pieprasījuma pamatteksts
JSON. ref un externalOrderId ir obligāti, pārējais ir pēc izvēles. Nosūtītā komisija tiek ignorēta: patiesības avots ir virsgrāmata.
| Lauks | Tips | Obligāts | Apraksts |
|---|---|---|---|
ref | string | Jā | Attiecinājuma identifikators formātā partnerCode-shortCode. |
externalOrderId | string | Jā | Jūsu pasūtījuma numurs. Atlas pusē darbojas kā idempotences atslēga. |
amount | number | Nē | Pārdevuma bruto summa tās valūtā. |
currency | string (3) | Nē | ISO 4217 kods. Nezināma valūta tiek saglabāta kā needs_fx un cenota vēlāk. |
status | enum | Nē | pending, validated vai cancelled. Noklusējums ir pending. |
subId | string | Nē | Kampaņas vai satura apakšidentifikators jūsu atskaitēm. |
Atbildes kodi
Ko API atgriež
Skaidri HTTP kodi. Aizliegtas statusa pārejas nekad netiek piemērotas klusējot.
| Kods | Nozīme |
|---|---|
200 | Konversija reģistrēta. action: inserted, updated, transitioned vai unchanged. |
400 | Trūkstoši lauki, nederīgs ref vai ref, kas nepieder saites īpašniekam. |
401 | Nederīgs paraksts, atslēga vai timestamp (5 minūšu logs). |
404 | Šim ref nav atrasta neviena saite. |
409 | Aizliegta statusa pāreja: stāvokļu mašīna to noraida. |
422 | Summa pārsniedz drošības griestus vienai konversijai. |
Autentifikācija un drošība
Parakstīts, norobežots, revidējams
Katram izsaucējam ir sava atslēga un savs noslēpums. Nekas netiek koplietots, visu var atsaukt.
Atslēgas katram izsaucējam
Atsevišķs key_id un signing secret katrai integrācijai. Vienu atsaucat, pārējās nepieskarat.
HMAC-SHA256 paraksts
Paraksts aptver timestamp.body baitu pa baitam. Jebkuras izmaiņas pamattekstā padara pieprasījumu nederīgu.
Aizsardzība pret replay
Pieprasījumi, kuru timestamp atšķiras vairāk nekā par 5 minūtēm, tiek noraidīti. Pārtvertu pieprasījumu nevar atkārtot.
Idempotenta stāvokļu mašīna
pending uz validated vai cancelled; validated tikai uz cancelled; cancelled ir galīgs. Tā paša statusa atkārtota nosūtīšana neko nemaina.
Uzticamība un atbalsts
Būvēts, lai turētos, atbild cilvēki
Konversijas API un izsekojamās saites darbojas Cloudflare edge tīklā. Uz to varat paļauties pieejamības, atkārtojumu un atbalsta ziņā.
99.9%
Mērķa pieejamība
Postback un izsekojamās saites darbojas Cloudflare Workers ar automātisku pārslēgšanu. Neviens atsevišķs reģions nevar apturēt pakalpojumu.
300+
Edge atrašanās vietas
Pieprasījumus apkalpo tuvākais Cloudflare punkts; komisija un valūtas maiņa pēc tam tiek rēķinātas asinhroni, ārpus jūsu kases kritiskā ceļa.
< 24h
Atbalsta atbildes laiks
E-pasta atbalsts atbild vienas darba dienas laikā. Integrācijas jautājumi nonāk pie partneru inženieru komandas, nevis anonīmā rindā.
5 min
Drošs atkārtojuma logs
Idempotents pēc externalOrderId: atkārtojiet pēc jebkuras noildzes bez dubultas skaitīšanas, un pārtverts pieprasījums pēc piecām minūtēm ir nederīgs.
Statusa lapa ir publiska: API pārbaude tiešraidē, pie kā mēs apņemamies, un katrs incidents kopš API atvēršanas. Jūsu kontakts integrācijai un incidentiem paliek partneru komanda, sasniedzama no kontaktu lapas. API statuss →
AI aģenti
Jūsu aģents izsauc rīku, HelloSafe atgriež īstu cenu
MCP serveris piedāvā cenošanu, salīdzinājumu un kartes pārbaudi kā tipizētus rīkus. Piekļuve pēc pieprasījuma.
MCP serveris
Nekādas integrācijas uz apdrošinātāju, nekādas cenošanas loģikas, ko rakstīt, nekādas regulējuma santehnikas. Jūsu kopilots, jūsu tērzēšanas robots vai jūsu rezervācijas plūsma izsauc rīku un saņem īstu piedāvājumu ar limitiem un dokumentiem. Pastāstiet, ko jūs būvējat.
Tehniskie jautājumi
Ko komandas jautā pirms integrācijas.
Cik maksā API?
Neko. Nav ne iestatīšanas maksas, ne ikmēneša platformas maksas, ne maksas par izsaukumu konversijas API vai dziļajām saitēm. Jūs nopelnāt 50 % komisiju no pārdevumiem, ko atnes jūsu integrācija; tā ir vienīgā naudas plūsma programmā.
Vai ir REST API cenošanai?
Abi darbojas. Konversijas API (postback) un cenu REST API: izveidojiet kontu, ar vienu klikšķi izveidojiet sandbox atslēgu un pieprasiet ražošanas piekļuvi, kad integrācija strādā.
Kā darbojas autentifikācija?
Parakstītas atslēgas katram izsaucējam. Jūs aprēķināt noslēpuma HMAC-SHA256 pār timestamp.body un nosūtāt to galvenē x-atlas-signature, ar 5 minūšu replay logu. Vecāks Bearer ceļš pastāv, kamēr esošie izsaucēji migrē.
Kādā valūtā sūtīt summu?
Bruto summu tās valūtā kopā ar valūtas kodu. Atlas fiksē kursu saņemšanas brīdī, pārrēķina eiro (grāmatvedības valūta) un aprēķina komisiju pēc jūsu likmes. Nosūtītā komisija tiek ignorēta.
Vai postback ir idempotents?
Jā. Atslēga ir externalOrderId: tā paša statusa atkārtota nosūtīšana neko nemaina, un stāvokļu mašīna noraida aizliegtas pārejas ar 409, nevis piemēro tās klusējot.
Vai varu integrēties caur Impact, Partnerize vai Awin?
Jā. Mēs piedāvājam standarta S2S postback, kas tieši savienojas ar Impact, Partnerize, Awin, Voluum, RedTrack un Everflow. Konversijas varat sūtīt arī uz savu BI webhook vai eksportēt CSV.
Vai jums ir OpenAPI specifikācija?
Jā, publiska un bez pieteikšanās. Atsauces lapa tiek ģenerēta no šīs specifikācijas katrā būvējumā, tāpēc dokumentācija un līgums nevar atšķirties.
Vai atbalstāt MCP?
Privātajā beta. MCP serveris piedāvā cenošanu, salīdzināšanu un noslēgšanu kā tipizētus rīkus, ko jūsu LLM vai aģents var izsaukt.
Uz kādu pieejamību un atbalstu varu rēķināties?
Konversijas API un izsekojamās saites darbojas Cloudflare Workers ar automātisku pārslēgšanu; mērķējam uz 99,9 % pieejamību. E-pasta atbalsts atbild vienas darba dienas laikā, un integrācijas jautājumi nonāk pie partneru inženieru komandas. Statusa lapa ir publiska.
Vai Coach vajag otru atslēgu?
Nē. Viena atslēga atver visu API: cenas, izsekojamās saites un Coach. Tas pats paraksts, tas pats skaitītājs, tās pašas kvotas.
Tehnisks vai komerciāls jautājums? Sazinieties ar mums
Būvējam
Pievienojiet ceļojumu apdrošināšanu savam produktam
Izveidojiet kontu un ar vienu klikšķi izveidojiet sandbox atslēgu: fiksēti parauga dati, neviens apdrošinātājs netiek izsaukts, nekas nav jāparaksta. Ražošanas piekļuve ir īsa izskatīšana, kad integrācija strādā.