50
Vjaġġaturi għal kull offerta
Tista' tikkalkula l-prezz għal minn persuna waħda sa 50 f'sejħa waħda. Fuq għaxar vjaġġaturi jieħu f'idejh il-prodott tal-grupp: l-istess prezz għal kull persuna, tkun xi tkun l-età.
Pjattaforma għall-iżviluppaturi
L-API biex tbigħ assigurazzjoni tal-ivvjaġġar ġewwa l-prodott tiegħek
API tal-konverżjoni ffirmata, deep links intraċċati u postback S2S lejn l-istack tiegħek. B'xejn biex tintegra u b'xejn għal kull sejħa: titħallas bil-kummissjoni.
X'hemm wara l-API
Il-katalgu
193
Pajjiżi ta' residenza
Il-vjaġġatur jikseb prezz minn liema pajjiż jitlaq.
193
Destinazzjonijiet
Id-destinazzjonijiet kollha, inklużi żoni ta' riskju.
26
Lingwi
Il-proċess, id-dokumenti u s-sommarju bil-lingwa tal-vjaġġatur.
33
Muniti
Il-prezz jidher fil-munita tal-vjaġġatur.
28
Garanziji
Saħħa, assistenza, vjaġġ, bagalji, responsabbiltà, attivitajiet, expat. Limiti u eċċessi fir-risposta.
Dak li m'għandekx bżonn tibni
Tliet affarijiet li qatt mhux se tibni
L-ebda liċenzja tiegħek
HelloSafe hija d-distributur reġistrat u ġġorr il-konformità. Int iddaħħal l-esperjenza, mhux ir-regolamentazzjoni.
L-ebda integrazzjoni għal kull assiguratur
Sejħa waħda, il-katalgu kollu. Il-konnessjonijiet, il-bidliet fil-prodotti u d-dokumenti kuntrattwali jibqgħu magħna.
L-ebda bejjiegħ x'iċċempel
Iċ-ċavetta sandbox hija klikk waħda 'l bogħod mill-kont tiegħek. Bla reviżjoni, bla karta, bla laqgħa.
Toroq ta' integrazzjoni
Ħames modi kif tqabbad HelloSafe
Minn link intraċċat imwaqqaf f'wara nofsinhar sa REST API għall-prezzijiet: agħżel il-livell ta' integrazzjoni tiegħek. L-istess kopertura, l-istess kummissjonijiet.
Deep links intraċċati
Link intraċċat wieħed għal kull kontenut jew kampanja, b'Sub-ID. L-aktar bidu mgħaġġel, mingħajr kodiċi.
- Deep links skont il-paġna u skont l-offerta
- Sub-ID skont il-kampanja, il-kontenut jew il-punt tal-bejgħ
- Cookie ta' attribuzzjoni ta' 90 jum, last-click
API tal-postback tal-konverżjoni
Għarraf lil Atlas meta bejgħ attribwit jasal jew jibdel l-istat. Talba ffirmata bl-HMAC, magna tal-istati, idempotenti.
- Ċwievet iffirmati għal kull sejjieħ (HMAC-SHA256)
- Stati: pending, validated, cancelled
- Ammont fil-munita tiegħu: il-kummissjoni tinħadem mis-server
Postback S2S lejn l-istack tiegħek
Ibgħat il-konverżjonijiet fejn tmexxi n-negozju: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow jew webhook lejn il-BI.
- Konnetturi S2S standard
- Webhook lejn il-BI tiegħek
- Esportazzjoni CSV
REST API għall-prezzijiet
Ikkalkula l-prezz ta' vjaġġ ma' diversi assiguraturi, oħloq il-link tal-bejgħ intraċċat u ara x'ma tkoprix il-karta tal-vjaġġatur. Ċavetta waħda għal kollox. Iftaħ kont u ċ-ċavetta sandbox tkun klikk 'il bogħod.
- Offerti f'ħin reali minn diversi assiguraturi
- Link tal-bejgħ intraċċat b'attribuzzjoni mibnija fih
- Dokumentazzjoni pubblika u speċifikazzjoni OpenAPI
Server MCP għall-aġenti tal-IA
Għodod tipizzati biex l-LLM jew l-aġent tiegħek ifittex, iqabbel u jikkonkludi, ibbażat fuq data reali.
- Għodod tipizzati għal Claude, ChatGPT u aġenti tiegħek
- Risposti mibnija fuq data vera
- Checkout minn aġent
Dokumentazzjoni
Aqra qabel tibni
Id-dokumentazzjoni hija pubblika u bl-Ingliż. Bla login, bla formola: kull ma twieġeb l-API huwa miktub.
Bidu mgħaġġel
Ċavetta sandbox, talba ffirmata, l-ewwel offerti bi prezz. Node, cURL u PHP.
Bidu mgħaġġel →Referenza tal-API
Endpoints, kampi tal-vjaġġ, kodiċi tal-garanziji, kodiċi tal-iżbalji u kwoti.
Referenza tal-API →Speċifikazzjoni OpenAPI
Il-kuntratt li jinqara mill-magni, għall-ġeneratur tal-klijent tiegħek.
Speċifikazzjoni OpenAPI →Status tal-API
Kontroll tal-API f'ħin reali, impenji ta' disponibbiltà u reġistru tal-inċidenti.
Status tal-API →L-API tal-konverżjoni fil-prattika
Mill-postback sal-kummissjoni, f'talba ffirmata waħda
L-API tal-konverżjoni qed taħdem illum. Tibgħat bejgħ attribwit, Atlas iqabblu mal-link, jikkonverti f'ewro u jikkalkula l-kummissjoni skont ir-rata tiegħek.
- 01
Ikseb ċavetta
Fil-fażi tat-tnedija ċ-ċwievet jingħataw fuq talba. Tirċievi key_id u signing secret li jgħoddu biss għall-integrazzjoni tiegħek.
- 02
Iffirma t-talba
Ikkalkula l-HMAC-SHA256 tas-sigriet fuq timestamp.body, imbagħad ibgħat l-intestaturi x-atlas-key-id, x-atlas-timestamp u x-atlas-signature. It-tieqa tar-replay hija ta' 5 minuti.
- 03
Ibgħat il-konverżjoni
Ibgħat ref u externalOrderId, flimkien mal-ammont gross fil-munita tiegħu u l-istat. Atlas jissikka r-rata, jikkalkula l-kummissjoni u jirritorna l-istat applikat.
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" }Talba ffirmata waħda. Atlas iwieġeb bl-istat applikat u l-kummissjoni kkalkulata.
Referenza tal-payload
Il-korp tat-talba
JSON. ref u externalOrderId huma obbligatorji, il-bqija fakultattiv. Kummissjoni li tibgħat tiġi injorata: is-sors tal-verità huwa r-reġistru.
| Kamp | Tip | Obbligatorju | Deskrizzjoni |
|---|---|---|---|
ref | string | Iva | Identifikatur tal-attribuzzjoni, fil-format partnerCode-shortCode. |
externalOrderId | string | Iva | In-numru tal-ordni tiegħek. Min-naħa ta' Atlas jaħdem bħala ċavetta tal-idempotenza. |
amount | number | Le | Ammont gross tal-bejgħ, fil-munita tiegħu. |
currency | string (3) | Le | Kodiċi ISO 4217. Munita mhux magħrufa tinħażen bħala needs_fx u tiġi pprezzata aktar tard. |
status | enum | Le | pending, validated jew cancelled. Awtomatikament pending. |
subId | string | Le | Sottoidentifikatur tal-kampanja jew tal-kontenut, għar-rappurtar tiegħek. |
Kodiċi tar-risposta
X'jirritorna l-API
Kodiċi HTTP ċari. Tranżizzjonijiet ta' stat ipprojbiti qatt ma jiġu applikati fis-skiet.
| Kodiċi | Tifsira |
|---|---|
200 | Konverżjoni rreġistrata. action: inserted, updated, transitioned jew unchanged. |
400 | Kampi nieqsa, ref invalidu jew ref li ma jappartjenix lis-sid tal-link. |
401 | Firma, ċavetta jew timestamp invalidi (tieqa ta' 5 minuti). |
404 | Ma nstab l-ebda link għal dan ir-ref. |
409 | Tranżizzjoni ta' stat ipprojbita: il-magna tal-istati tirrifjutaha. |
422 | Ammont ogħla mil-limitu ta' sigurtà għal kull konverżjoni. |
Awtentikazzjoni u sigurtà
Iffirmat, limitat, verifikabbli
Kull sejjieħ għandu ċ-ċavetta tiegħu u s-sigriet tiegħu. Xejn ma jinqasam, kollox jista' jiġi revokat.
Ċwievet għal kull sejjieħ
key_id u signing secret separati għal kull integrazzjoni. Tirrevoka wieħed mingħajr ma tmiss l-oħrajn.
Firma HMAC-SHA256
Il-firma tkopri timstamp.body byte b'byte. Kull tibdil fil-korp jinvalida t-talba.
Protezzjoni kontra r-replay
Talbiet li t-timestamp tagħhom jitbiegħed aktar minn 5 minuti jiġu miċħuda. Talba maqbuda ma tistax terġa' tindaqq.
Magna tal-istati idempotenti
pending għal validated jew cancelled; validated biss għal cancelled; cancelled huwa finali. Li tibgħat l-istess stat mill-ġdid ma jagħmel xejn.
Affidabbiltà u appoġġ
Mibni biex jibqa' għaddej, imwieġeb minn nies
L-API tal-konverżjoni u l-links intraċċati jaħdmu fuq in-network edge ta' Cloudflare. Fuq dan tista' tibbaża għad-disponibbiltà, ir-ripetizzjonijiet u l-appoġġ.
99.9%
Disponibbiltà mmirata
Il-postbacks u l-links intraċċati jaħdmu fuq Cloudflare Workers b'qabża awtomatika. L-ebda reġjun waħdu ma jista' jwaqqaf is-servizz.
300+
Postijiet edge
It-talbiet jiġu servuti mill-eqreb punt ta' Cloudflare; il-kummissjoni u l-kambju tal-munita jinħadmu wara, b'mod asinkroniku, barra mit-triq kritika tal-checkout tiegħek.
< 24h
Ħin ta' risposta tal-appoġġ
L-appoġġ bl-email iwieġeb fi żmien jum tax-xogħol. Il-mistoqsijiet dwar l-integrazzjoni jaslu għand it-tim tal-inġinerija tas-sħab, mhux f'kju anonimu.
5 min
Tieqa sikura għar-ripetizzjoni
Idempotenti skont externalOrderId: erġa' pprova wara kull timeout mingħajr għadd doppju, u talba maqbuda ssir bla użu wara ħames minuti.
Il-paġna tal-istatus hija pubblika: kontroll tal-API f'ħin reali, dak li nimpenjaw ruħna għalih, u kull inċident minn meta nfetħet l-API. Il-kuntatt tiegħek għall-integrazzjoni u l-inċidenti jibqa' t-tim tas-sħab, li tilħaq mill-paġna tal-kuntatt. Status tal-API →
Aġenti tal-IA
L-aġent tiegħek isejjaħ għodda, HelloSafe jirritorna prezz veru
Is-server MCP jesponi l-ipprezzar, it-tqabbil u l-verifika tal-karta bħala għodod tipizzati. Aċċess fuq talba.
Server MCP
L-ebda integrazzjoni għal kull assiguratur, l-ebda loġika tal-ipprezzar x'tikteb, l-ebda plombing regolatorju. Il-copilot tiegħek, iċ-chatbot tiegħek jew il-fluss tal-ibbukkjar tiegħek isejjaħ għodda u jirċievi offerta vera, bil-limiti u d-dokumenti tagħha. Għidilna x'qed tibni.
Mistoqsijiet tekniċi
Dak li t-timijiet jistaqsu qabel jintegraw.
Kemm tiswa l-API?
Xejn. M'hemmx tariffa tat-twaqqif, m'hemmx tariffa mensili tal-pjattaforma u m'hemmx spiża għal kull sejħa fuq l-API tal-konverżjoni jew id-deep links. Taqla' 50 % tal-kummissjonijiet fuq il-bejgħ li ġġib l-integrazzjoni tiegħek; dak huwa l-uniku fluss ta' flus fil-programm.
Hemm REST API għall-prezzijiet?
It-tnejn jaħdmu. L-API tal-konverżjoni (postback) u r-REST API għall-prezzijiet: iftaħ kont, oħloq ċavetta sandbox bi klikk waħda u itlob aċċess għall-produzzjoni meta l-integrazzjoni tiegħek tkun qed taħdem.
Kif taħdem l-awtentikazzjoni?
Ċwievet iffirmati għal kull sejjieħ. Tikkalkula l-HMAC-SHA256 tas-sigriet fuq timestamp.body u tibagħtu f'x-atlas-signature, b'tieqa ta' replay ta' 5 minuti. Triq eqdem bil-Bearer teżisti sakemm is-sejjieħa attwali jaqilbu.
F'liema munita nibgħat l-ammont?
L-ammont gross fil-munita tiegħu, flimkien mal-kodiċi tal-munita. Atlas jissikka r-rata mal-wasla, jikkonverti f'ewro (il-munita tal-kontabbiltà) u jikkalkula l-kummissjoni skont ir-rata tiegħek. Kummissjoni li tibgħat tiġi injorata.
Il-postback huwa idempotenti?
Iva. Iċ-ċavetta hija externalOrderId: li tibgħat l-istess stat mill-ġdid ma jagħmel xejn, u l-magna tal-istati tirrifjuta t-tranżizzjonijiet ipprojbiti b'409 minflok ma tapplikahom fis-skiet.
Nista' nintegra permezz ta' Impact, Partnerize jew Awin?
Iva. Noffru postback S2S standard li jaqbad direttament ma' Impact, Partnerize, Awin, Voluum, RedTrack u Everflow. Tista' wkoll tibgħat il-konverżjonijiet lejn webhook BI tiegħek jew tesportahom f'CSV.
Għandkom speċifikazzjoni OpenAPI?
Iva, pubblika u mingħajr login. Il-paġna ta' referenza tinħoloq minn dik l-ispeċifikazzjoni ma' kull build, għalhekk id-dokumentazzjoni u l-kuntratt ma jistgħux jinfirdu.
Tappoġġaw l-MCP?
F'beta privata. Is-server MCP jesponi l-ipprezzar, it-tqabbil u l-konklużjoni bħala għodod tipizzati li l-LLM jew l-aġent tiegħek jista' jsejjaħ.
Fuq liema disponibbiltà u appoġġ nista' noqgħod?
L-API tal-konverżjoni u l-links intraċċati jaħdmu fuq Cloudflare Workers b'qabża awtomatika; nimmiraw għal 99,9 % disponibbiltà. L-appoġġ bl-email iwieġeb fi żmien jum tax-xogħol u l-mistoqsijiet dwar l-integrazzjoni jaslu għand it-tim tal-inġinerija tas-sħab. Il-paġna tal-istatus hija pubblika.
Coach jeħtieġ tieni ċavetta?
Le. Ċavetta waħda tiftaħ l-API kollha: l-ipprezzar, il-links intraċċati u Coach. L-istess firma, l-istess kontatur, l-istess kwoti.
Mistoqsija teknika jew kummerċjali? Ikkuntattjana
Nibnu
Żid assigurazzjoni tal-ivvjaġġar mal-prodott tiegħek
Iftaħ il-kont tiegħek u oħloq ċavetta sandbox bi klikk waħda: data ta' kampjun fissa, l-ebda assiguratur ma jissejjaħ, xejn x'tiffirma. L-aċċess għall-produzzjoni huwa reviżjoni qasira ladarba l-integrazzjoni tiegħek tkun qed taħdem.