HelloSafe

Í hvaða landi býrð þú?

Þróunarvettvangur

API-ið til að selja ferðatryggingu inni í vörunni þinni

Undirritað umbreytingar-API, raktir djúptenglar og S2S postback inn í stakkinn þinn. Ókeypis að tengja og ókeypis á hverja beiðni: þú færð greitt í þóknun.

Ókeypis sandbox lykill Skoða umbreytingar-API

Það sem liggur að baki API-inu

Skráin

50

Ferðalangar á tilboð

Þú getur verðlagt 1 til 50 einstaklinga í einni beiðni. Yfir tíu ferðalanga tekur hópvaran við: sama verð á mann, óháð aldri.

193

Búsetulönd

Ferðalangurinn fær verð, sama frá hvaða landi hann leggur af stað.

193

Áfangastaðir

Allir áfangastaðir, áhættusvæði meðtalin.

26

Tungumál

Ferli, skjöl og samantekt á tungumáli ferðalangsins.

33

Gjaldmiðlar

Verðið birtist í gjaldmiðli ferðalangsins.

28

Tryggingaliðir

Heilsa, aðstoð, ferð, farangur, ábyrgð, afþreying, expat. Hámörk og sjálfsábyrgð í svarinu.

Það sem þú þarft ekki að byggja

Þrennt sem þú munt aldrei byggja

Ekkert eigið starfsleyfi

HelloSafe er skráði dreifingaraðilinn og ber regluvörsluna. Þú byggir inn upplifunina, ekki regluverkið.

Engin tenging við hvert tryggingafélag

Ein beiðni, öll skráin. Tengingarnar, vörubreytingarnar og samningsskjölin sitja hjá okkur.

Enginn sölumaður til að hringja í

Sandbox lykillinn er einum smelli frá reikningnum þínum. Engin yfirferð, ekkert kort, enginn fundur.

Tengileiðir

Fimm leiðir til að tengja HelloSafe

Frá röktum tengli sem settur er upp á einu síðdegi yfir í REST API fyrir verðlagningu: veldu þitt tengistig. Sama vernd, sömu þóknanir.

Í rekstri

Raktir djúptenglar

Einn rakinn tengill á hvert efni eða herferð, með Sub-ID. Fljótlegasta byrjunin, án kóða.

  • Djúptenglar eftir síðu og tilboði
  • Sub-ID eftir herferð, efni eða sölustað
  • 90 daga rakningarkaka, last-click
Í rekstri

API fyrir umbreytingar-postback

Láttu Atlas vita þegar eignuð sala berst eða skiptir um stöðu. HMAC-undirrituð beiðni, stöðuvél, ítrekunarheld.

  • Undirritaðir lyklar á hvern kallanda (HMAC-SHA256)
  • Stöður: pending, validated, cancelled
  • Upphæð í eigin gjaldmiðli: þjónninn reiknar þóknunina
Í rekstri

S2S postback inn í stakkinn þinn

Sendu umbreytingar þangað sem þú rekur reksturinn: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow eða BI-webhook.

  • Staðlaðar S2S tengingar
  • Webhook í BI-kerfið þitt
  • CSV útflutningur
Í rekstri

REST API fyrir verðlagningu

Verðleggðu ferð hjá mörgum tryggingafélögum, búðu til rakta sölutengilinn og sjáðu hvað kort ferðalangsins nær ekki yfir. Einn lykill fyrir allt. Stofnaðu reikning og sandbox lykillinn er einum smelli í burtu.

  • Rauntímatilboð frá mörgum tryggingafélögum
  • Rakinn sölutengill með innbyggðri eignun
  • Opinber skjölun og OpenAPI-lýsing
Lokuð beta

MCP-þjónn fyrir gervigreindarumboð

Tegundagreind verkfæri svo LLM-ið þitt eða umboðið geti leitað, borið saman og gengið frá, byggt á lifandi gögnum.

  • Tegundagreind verkfæri fyrir Claude, ChatGPT og eigin umboð
  • Svör byggð á raunverulegum gögnum
  • Checkout í höndum umboðs

Skjölun

Lestu áður en þú byggir

Skjölunin er opinber og á ensku. Engin innskráning, ekkert eyðublað: allt sem API-ið svarar er skráð.

Skyndibyrjun

Sandbox lykill, undirrituð beiðni, fyrstu verðlögðu tilboðin. Node, cURL og PHP.

Skyndibyrjun →

API-uppflettirit

Endapunktar, ferðareitir, tryggingakóðar, villukóðar og kvótar.

API-uppflettirit →

OpenAPI-lýsing

Vélræni samningurinn, fyrir biðlaragjörvann þinn.

OpenAPI-lýsing →

Staða API

Lifandi eftirlit með API-inu, skuldbindingar um aðgengi og atvikaskrá.

Staða API →

Umbreytingar-API-ið í reynd

Frá postback til þóknunar, í einni undirritaðri beiðni

Umbreytingar-API-ið er í rekstri í dag. Þú sendir eignaða sölu, Atlas parar hana við tengilinn, umreiknar í evrur og reiknar þóknunina eftir þínum taxta.

  1. 01

    Fáðu lykil

    Á upphafsstigi eru lyklar veittir eftir beiðni. Þú færð key_id og signing secret sem gilda eingöngu fyrir þína tengingu.

  2. 02

    Undirritaðu beiðnina

    Reiknaðu HMAC-SHA256 af leyndarmálinu yfir timestamp.body og sendu svo hausana x-atlas-key-id, x-atlas-timestamp og x-atlas-signature. Replay-glugginn er 5 mínútur.

  3. 03

    Sendu umbreytinguna

    Sendu ref og externalOrderId, ásamt heildarupphæðinni í eigin gjaldmiðli og stöðunni. Atlas læsir genginu, reiknar þóknunina og skilar beittu stöðunni.

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" }

Ein undirrituð beiðni. Atlas svarar með beittu stöðunni og reiknaðri þóknun.

Payload-uppflettirit

Meginmál beiðninnar

JSON. ref og externalOrderId eru skylda, annað valfrjálst. Þóknun sem þú sendir með er hunsuð: sannleiksuppspretta er höfuðbókin.

Reitur Tegund Skylda Lýsing
ref string Já Eignunarauðkenni á sniðinu partnerCode-shortCode.
externalOrderId string Já Pöntunarnúmerið þitt. Atlas-megin virkar það sem ítrekunarlykill.
amount number Nei Heildarupphæð sölunnar, í eigin gjaldmiðli.
currency string (3) Nei ISO 4217 kóði. Óþekktur gjaldmiðill er vistaður sem needs_fx og verðlagður síðar.
status enum Nei pending, validated eða cancelled. Sjálfgefið pending.
subId string Nei Undirauðkenni herferðar eða efnis, fyrir þína skýrslugerð.

Svarkóðar

Hverju API-ið skilar

Skýrir HTTP-kóðar. Bannaðar stöðubreytingar eru aldrei framkvæmdar í kyrrþey.

Kóði Merking
200 Umbreyting skráð. action: inserted, updated, transitioned eða unchanged.
400 Reiti vantar, ógilt ref eða ref sem tilheyrir ekki eiganda tengilsins.
401 Ógild undirskrift, lykill eða timestamp (5 mínútna gluggi).
404 Enginn tengill fannst fyrir þetta ref.
409 Bönnuð stöðubreyting: stöðuvélin hafnar henni.
422 Upphæð yfir öryggisþaki á hverja umbreytingu.

Auðkenning og öryggi

Undirritað, afmarkað, rekjanlegt

Hver kallandi hefur sinn lykil og sitt leyndarmál. Ekkert er sameiginlegt, allt má afturkalla.

Lyklar á hvern kallanda

Sérstakt key_id og signing secret fyrir hverja tengingu. Þú afturkallar einn án þess að snerta hina.

HMAC-SHA256 undirskrift

Undirskriftin nær yfir timestamp.body bæti fyrir bæti. Sérhver breyting á meginmálinu ógildir beiðnina.

Vörn gegn replay

Beiðnum þar sem timestamp skeikar meira en 5 mínútum er hafnað. Beiðni sem hlerað er verður ekki spiluð aftur.

Ítrekunarheld stöðuvél

pending í validated eða cancelled; validated aðeins í cancelled; cancelled er endanlegt. Að senda sömu stöðu aftur gerir ekkert.

Áreiðanleiki og stuðningur

Byggt til að haldast uppi, fólk svarar

Umbreytingar-API-ið og röktu tenglarnir keyra á edge-neti Cloudflare. Þetta er það sem þú getur reitt þig á varðandi aðgengi, endurtekningar og stuðning.

99.9%

Markmið um aðgengi

Postback og raktir tenglar keyra á Cloudflare Workers með sjálfvirkri yfirfærslu. Ekkert eitt svæði getur fellt þjónustuna.

300+

Edge-staðsetningar

Beiðnum er svarað frá næsta Cloudflare-punkti; þóknun og gjaldmiðlaskipti reiknast svo ósamstillt, utan við mikilvægu leið afgreiðslunnar þinnar.

< 24h

Svartími stuðnings

Tölvupóststuðningur svarar innan eins virks dags. Spurningar um tengingu berast til samstarfsverkfræðiteymisins, ekki í nafnlausa biðröð.

5 min

Öruggur endurtekningargluggi

Ítrekunarheld eftir externalOrderId: endurtaktu eftir hvaða tímamörk sem er án tvítalningar, og hleruð beiðni er ónothæf eftir fimm mínútur.

Stöðusíðan er opinber: lifandi eftirlit með API-inu, það sem við skuldbindum okkur til og hvert atvik frá því API-ið opnaði. Tengiliður þinn vegna tengingar og atvika er áfram samstarfsteymið, sem næst frá tengiliðasíðunni. Staða API →

Gervigreindarumboð

Umboðið þitt kallar á verkfæri, HelloSafe skilar raunverulegu verði

MCP-þjónninn birtir verðlagningu, samanburð og kortaskoðun sem tegundagreind verkfæri. Aðgangur eftir beiðni.

Eftir beiðni

MCP-þjónn

Engin tenging við hvert tryggingafélag, engin verðlagningarrökfræði til að skrifa, engin regluverkspípulögn. Aðstoðarmaðurinn þinn, spjallmennið þitt eða bókunarferlið þitt kallar á verkfæri og fær raunverulegt tilboð til baka, með hámörkum og skjölum. Segðu okkur hvað þú ert að byggja.

Tæknilegar spurningar

Það sem teymi spyrja um áður en þau tengja.

Hvað kostar API-ið?

Ekkert. Það er ekkert uppsetningargjald, ekkert mánaðargjald fyrir vettvanginn og enginn kostnaður á hverja beiðni í umbreytingar-API-inu eða djúptenglunum. Þú vinnur þér inn 50 % af þóknunum af sölu sem tengingin þín skapar; það er eina peningaflæðið í kerfinu.

Er til REST API fyrir verðlagningu?

Bæði eru í rekstri. Umbreytingar-API-ið (postback) og REST API fyrir verðlagningu: stofnaðu reikning, búðu til sandbox lykil með einum smelli og sæktu um raunaðgang þegar tengingin er komin í gang.

Hvernig virkar auðkenningin?

Undirritaðir lyklar á hvern kallanda. Þú reiknar HMAC-SHA256 af leyndarmálinu yfir timestamp.body og sendir það í x-atlas-signature, með 5 mínútna replay-glugga. Eldri Bearer-leið er til á meðan núverandi kallendur færa sig.

Í hvaða gjaldmiðli á ég að senda upphæðina?

Heildarupphæðina í eigin gjaldmiðli, ásamt gjaldmiðilskóðanum. Atlas læsir genginu við móttöku, umreiknar í evrur (bókhaldsgjaldmiðilinn) og reiknar þóknunina eftir þínum taxta. Þóknun sem þú sendir með er hunsuð.

Er postback-ið ítrekunarhelt?

Já. Lykillinn er externalOrderId: að senda sömu stöðu aftur gerir ekkert, og stöðuvélin hafnar bönnuðum breytingum með 409 í stað þess að framkvæma þær í kyrrþey.

Get ég tengst í gegnum Impact, Partnerize eða Awin?

Já. Við bjóðum staðlað S2S postback sem tengist beint við Impact, Partnerize, Awin, Voluum, RedTrack og Everflow. Þú getur líka sent umbreytingar á þitt eigið BI-webhook eða flutt þær út í CSV.

Eruð þið með OpenAPI-lýsingu?

Já, opinbera og án innskráningar. Uppflettisíðan er mynduð úr þeirri lýsingu í hverri byggingu, svo skjölun og samningur geta ekki rekið í sundur.

Styðjið þið MCP?

Í lokaðri beta. MCP-þjónninn birtir verðlagningu, samanburð og frágang sem tegundagreind verkfæri sem LLM-ið þitt eða umboðið getur kallað á.

Hvaða aðgengi og stuðning get ég reiknað með?

Umbreytingar-API-ið og röktu tenglarnir keyra á Cloudflare Workers með sjálfvirkri yfirfærslu; við stefnum á 99,9 % aðgengi. Tölvupóststuðningur svarar innan eins virks dags og spurningar um tengingu berast til samstarfsverkfræðiteymisins. Stöðusíðan er opinber.

Þarf annan lykil fyrir Coach?

Nei. Einn lykill opnar allt API-ið: verðlagningu, rakta tengla og Coach. Sama undirskrift, sami teljari, sömu kvótar.

Tæknileg eða viðskiptaleg spurning? Hafðu samband

Byggjum

Bættu ferðatryggingu við vöruna þína

Stofnaðu reikning og búðu til sandbox lykil með einum smelli: föst sýnigögn, ekkert tryggingafélag kallað til, ekkert til að skrifa undir. Raunaðgangur er stutt yfirferð þegar tengingin er komin í gang.

Ókeypis sandbox lykill Lesa algengar spurningar