50
Ταξιδιώτες ανά προσφορά
Μπορείτε να τιμολογήσετε από 1 έως 50 άτομα με μία κλήση. Πάνω από δέκα ταξιδιώτες αναλαμβάνει το ομαδικό προϊόν: ίδια τιμή ανά άτομο, ανεξάρτητα από την ηλικία.
Πλατφόρμα για προγραμματιστές
Το API για να πουλάτε ταξιδιωτική ασφάλιση μέσα στο προϊόν σας
Υπογεγραμμένο API μετατροπών, παρακολουθούμενοι deep links και postback S2S προς το stack σας. Δωρεάν στην ενσωμάτωση και δωρεάν ανά κλήση: πληρώνεστε με προμήθεια.
Τι υπάρχει πίσω από το API
Ο κατάλογος
193
Χώρες διαμονής
Ο ταξιδιώτης λαμβάνει τιμή από όποια χώρα κι αν ξεκινά.
193
Προορισμοί
Όλοι οι προορισμοί, συμπεριλαμβανομένων των ζωνών κινδύνου.
26
Γλώσσες
Διαδρομή, έγγραφα και σύνοψη στη γλώσσα του ταξιδιώτη.
33
Νομίσματα
Η τιμή εμφανίζεται στο νόμισμα του ταξιδιώτη.
28
Καλύψεις
Υγεία, βοήθεια, ταξίδι, αποσκευές, ευθύνη, δραστηριότητες, expat. Ανώτατα όρια και απαλλαγές στην απάντηση.
Αυτά που δεν χρειάζεται να φτιάξετε
Τρία πράγματα που δεν θα φτιάξετε ποτέ
Καμία δική σας άδεια
Η HelloSafe είναι ο εγγεγραμμένος διανομέας και σηκώνει τη συμμόρφωση. Εσείς ενσωματώνετε την εμπειρία, όχι τη ρύθμιση.
Καμία ενσωμάτωση ανά ασφαλιστή
Μία κλήση, όλος ο κατάλογος. Οι συνδέσεις, οι αλλαγές προϊόντων και τα συμβατικά έγγραφα μένουν σε εμάς.
Κανένας πωλητής να καλέσετε
Το κλειδί sandbox απέχει ένα κλικ από τον λογαριασμό σας. Χωρίς εξέταση, χωρίς κάρτα, χωρίς ραντεβού.
Τρόποι ενσωμάτωσης
Πέντε τρόποι να συνδέσετε το HelloSafe
Από έναν παρακολουθούμενο σύνδεσμο σε ένα απόγευμα έως ένα REST API τιμολόγησης: διαλέξτε το επίπεδο ενσωμάτωσης. Ίδια κάλυψη, ίδιες προμήθειες.
Παρακολουθούμενοι deep links
Ένας παρακολουθούμενος σύνδεσμος ανά περιεχόμενο ή καμπάνια, με Sub-ID. Η πιο γρήγορη αρχή, χωρίς κώδικα.
- Deep links ανά σελίδα και ανά προσφορά
- Sub-ID ανά καμπάνια, περιεχόμενο ή σημείο πώλησης
- Cookie απόδοσης 90 ημερών, last-click
API postback μετατροπών
Ειδοποιήστε το Atlas όταν μια αποδοθείσα πώληση φτάνει ή αλλάζει κατάσταση. Αίτημα υπογεγραμμένο με HMAC, μηχανή καταστάσεων, ιδεμπότης.
- Υπογεγραμμένα κλειδιά ανά καλούντα (HMAC-SHA256)
- Καταστάσεις: pending, validated, cancelled
- Ποσό στο δικό του νόμισμα: την προμήθεια την υπολογίζει ο διακομιστής
Postback S2S προς το stack σας
Στείλτε τις μετατροπές εκεί όπου τρέχετε την επιχείρησή σας: Impact, Partnerize, Awin, Voluum, RedTrack, Everflow ή webhook προς το BI.
- Τυπικοί σύνδεσμοι S2S
- Webhook προς το BI σας
- Εξαγωγή CSV
REST API τιμολόγησης
Τιμολογήστε ένα ταξίδι σε πολλούς ασφαλιστές, δημιουργήστε τον παρακολουθούμενο σύνδεσμο πώλησης και δείτε τι δεν καλύπτει η κάρτα του ταξιδιώτη. Ένα κλειδί για όλα. Δημιουργήστε λογαριασμό και το κλειδί sandbox απέχει ένα κλικ.
- Προσφορές πολλών ασφαλιστών σε πραγματικό χρόνο
- Παρακολουθούμενος σύνδεσμος πώλησης με ενσωματωμένη απόδοση
- Δημόσια τεκμηρίωση και προδιαγραφή OpenAPI
Διακομιστής MCP για πράκτορες AI
Τυποποιημένα εργαλεία ώστε το LLM ή ο πράκτοράς σας να αναζητά, να συγκρίνει και να συνάπτει, με βάση ζωντανά δεδομένα.
- Τυποποιημένα εργαλεία για Claude, ChatGPT και δικούς σας πράκτορες
- Απαντήσεις θεμελιωμένες σε πραγματικά δεδομένα
- Checkout από πράκτορα
Τεκμηρίωση
Διαβάστε πριν χτίσετε
Η τεκμηρίωση είναι δημόσια και στα αγγλικά. Χωρίς σύνδεση, χωρίς φόρμα: ό,τι απαντά το API είναι γραμμένο.
Γρήγορη εκκίνηση
Κλειδί sandbox, υπογεγραμμένο αίτημα, πρώτες τιμολογημένες προσφορές. Node, cURL και PHP.
Γρήγορη εκκίνηση →Αναφορά API
Endpoints, πεδία ταξιδιού, κωδικοί καλύψεων, κωδικοί σφαλμάτων και όρια.
Αναφορά API →Προδιαγραφή OpenAPI
Το αναγνώσιμο από μηχανές συμβόλαιο, για τη γεννήτρια πελάτη σας.
Προδιαγραφή OpenAPI →Κατάσταση API
Ζωντανός έλεγχος του API, δεσμεύσεις διαθεσιμότητας και αρχείο συμβάντων.
Κατάσταση API →Το API μετατροπών στην πράξη
Από το postback στην προμήθεια, με ένα υπογεγραμμένο αίτημα
Το API μετατροπών λειτουργεί ήδη σήμερα. Στέλνετε μια αποδοθείσα πώληση, το Atlas την αντιστοιχίζει με τον σύνδεσμο, τη μετατρέπει σε ευρώ και υπολογίζει την προμήθεια με βάση τον δικό σας συντελεστή.
- 01
Αποκτήστε κλειδί
Στη φάση εκκίνησης τα κλειδιά χορηγούνται κατόπιν αιτήματος. Λαμβάνετε ένα key_id και ένα signing secret που ισχύουν μόνο για τη δική σας ενσωμάτωση.
- 02
Υπογράψτε το αίτημα
Υπολογίστε το HMAC-SHA256 του μυστικού πάνω στο timestamp.body και στείλτε τις κεφαλίδες x-atlas-key-id, x-atlas-timestamp και x-atlas-signature. Το παράθυρο replay είναι 5 λεπτά.
- 03
Στείλτε τη μετατροπή
Στείλτε ref και externalOrderId, μαζί με το μικτό ποσό στο δικό του νόμισμα και την κατάσταση. Το Atlas κλειδώνει την ισοτιμία, υπολογίζει την προμήθεια και επιστρέφει την εφαρμοσμένη κατάσταση.
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" }Ένα υπογεγραμμένο αίτημα. Το Atlas απαντά με την εφαρμοσμένη κατάσταση και την υπολογισμένη προμήθεια.
Αναφορά payload
Το σώμα του αιτήματος
JSON. Τα ref και externalOrderId είναι υποχρεωτικά, τα υπόλοιπα προαιρετικά. Όποια προμήθεια στείλετε αγνοείται: πηγή αλήθειας είναι το καθολικό.
| Πεδίο | Τύπος | Υποχρεωτικό | Περιγραφή |
|---|---|---|---|
ref | string | Ναι | Αναγνωριστικό απόδοσης, σε μορφή partnerCode-shortCode. |
externalOrderId | string | Ναι | Ο δικός σας αριθμός παραγγελίας. Στην πλευρά του Atlas λειτουργεί ως κλειδί ιδεμποτίας. |
amount | number | Όχι | Μικτό ποσό πώλησης, στο δικό του νόμισμα. |
currency | string (3) | Όχι | Κωδικός ISO 4217. Άγνωστο νόμισμα αποθηκεύεται ως needs_fx και τιμολογείται αργότερα. |
status | enum | Όχι | pending, validated ή cancelled. Προεπιλογή pending. |
subId | string | Όχι | Υπο-αναγνωριστικό καμπάνιας ή περιεχομένου, για τη δική σας αναφορά. |
Κωδικοί απάντησης
Τι επιστρέφει το API
Σαφείς κωδικοί HTTP. Απαγορευμένες μεταβάσεις κατάστασης δεν εφαρμόζονται ποτέ σιωπηλά.
| Κωδικός | Σημασία |
|---|---|
200 | Μετατροπή καταγράφηκε. action: inserted, updated, transitioned ή unchanged. |
400 | Λείπουν πεδία, μη έγκυρο ref ή ref που δεν ανήκει στον κάτοχο του συνδέσμου. |
401 | Μη έγκυρη υπογραφή, κλειδί ή timestamp (παράθυρο 5 λεπτών). |
404 | Δεν βρέθηκε σύνδεσμος για αυτό το ref. |
409 | Απαγορευμένη μετάβαση κατάστασης: η μηχανή καταστάσεων την απορρίπτει. |
422 | Ποσό πάνω από το όριο ασφαλείας ανά μετατροπή. |
Ταυτοποίηση και ασφάλεια
Υπογεγραμμένο, οριοθετημένο, ελέγξιμο
Κάθε καλών έχει δικό του κλειδί και δικό του μυστικό. Τίποτα δεν μοιράζεται, όλα ανακαλούνται.
Κλειδιά ανά καλούντα
Ξεχωριστό key_id και signing secret για κάθε ενσωμάτωση. Ανακαλείτε ένα χωρίς να αγγίξετε τα υπόλοιπα.
Υπογραφή HMAC-SHA256
Η υπογραφή καλύπτει το timestamp.body byte προς byte. Κάθε αλλαγή στο σώμα ακυρώνει το αίτημα.
Προστασία από replay
Αιτήματα με timestamp που αποκλίνει πάνω από 5 λεπτά απορρίπτονται. Ένα υποκλαπέν αίτημα δεν μπορεί να επαναληφθεί.
Ιδεμπότης μηχανή καταστάσεων
pending προς validated ή cancelled; validated μόνο προς cancelled; το cancelled είναι τελικό. Η εκ νέου αποστολή της ίδιας κατάστασης δεν κάνει τίποτα.
Αξιοπιστία και υποστήριξη
Φτιαγμένο να μένει όρθιο, με ανθρώπους να απαντούν
Το API μετατροπών και οι παρακολουθούμενοι σύνδεσμοι τρέχουν στο δίκτυο edge της Cloudflare. Σε αυτά μπορείτε να βασιστείτε για διαθεσιμότητα, επαναλήψεις και υποστήριξη.
99.9%
Στόχος διαθεσιμότητας
Τα postback και οι παρακολουθούμενοι σύνδεσμοι τρέχουν σε Cloudflare Workers με αυτόματη εναλλαγή. Καμία μεμονωμένη περιοχή δεν μπορεί να ρίξει την υπηρεσία.
300+
Σημεία edge
Τα αιτήματα εξυπηρετούνται από το πλησιέστερο σημείο Cloudflare· η προμήθεια και η μετατροπή νομίσματος υπολογίζονται μετά, ασύγχρονα, εκτός της κρίσιμης διαδρομής του ταμείου σας.
< 24h
Χρόνος απόκρισης υποστήριξης
Η υποστήριξη μέσω email απαντά εντός μίας εργάσιμης ημέρας. Οι ερωτήσεις ενσωμάτωσης φτάνουν στην ομάδα μηχανικών εταίρων, όχι σε ανώνυμη ουρά.
5 min
Ασφαλές παράθυρο επανάληψης
Ιδεμπότης βάσει externalOrderId: επαναλάβετε μετά από κάθε timeout χωρίς διπλή καταμέτρηση, και ένα υποκλαπέν αίτημα είναι άχρηστο μετά από πέντε λεπτά.
Η σελίδα κατάστασης είναι δημόσια: ζωντανός έλεγχος του API, σε τι δεσμευόμαστε, και κάθε συμβάν από το άνοιγμα του API. Η επαφή σας για ενσωμάτωση και συμβάντα παραμένει η ομάδα εταίρων, προσβάσιμη από τη σελίδα επικοινωνίας. Κατάσταση API →
Πράκτορες AI
Ο πράκτοράς σας καλεί ένα εργαλείο, η HelloSafe επιστρέφει πραγματική τιμή
Ο διακομιστής MCP εκθέτει την τιμολόγηση, τη σύγκριση και τον έλεγχο κάρτας ως τυποποιημένα εργαλεία. Πρόσβαση κατόπιν αιτήματος.
Διακομιστής MCP
Καμία ενσωμάτωση ανά ασφαλιστή, καμία λογική τιμολόγησης να γραφτεί, καμία ρυθμιστική υδραυλική. Ο copilot σας, το chatbot σας ή η ροή κράτησής σας καλεί ένα εργαλείο και παίρνει πίσω μια πραγματική προσφορά, με τα όριά της και τα έγγραφά της. Πείτε μας τι φτιάχνετε.
Τεχνικές ερωτήσεις
Τι ρωτούν οι ομάδες πριν ενσωματώσουν.
Πόσο κοστίζει το API;
Τίποτα. Δεν υπάρχει τέλος εγκατάστασης, μηνιαία συνδρομή πλατφόρμας ή χρέωση ανά κλήση στο API μετατροπών ή στους deep links. Κερδίζετε το 50 % των προμηθειών από τις πωλήσεις που φέρνει η ενσωμάτωσή σας· αυτή είναι η μόνη ροή χρημάτων στο πρόγραμμα.
Υπάρχει REST API τιμολόγησης;
Και τα δύο λειτουργούν. Το API μετατροπών (postback) και το REST API τιμολόγησης: δημιουργήστε λογαριασμό, φτιάξτε κλειδί sandbox με ένα κλικ και ζητήστε πρόσβαση παραγωγής μόλις τρέξει η ενσωμάτωσή σας.
Πώς λειτουργεί η ταυτοποίηση;
Υπογεγραμμένα κλειδιά ανά καλούντα. Υπολογίζετε το HMAC-SHA256 του μυστικού πάνω στο timestamp.body και το στέλνετε στο x-atlas-signature, με παράθυρο replay 5 λεπτών. Μια παλαιότερη διαδρομή Bearer υπάρχει όσο μεταναστεύουν οι υπάρχοντες καλούντες.
Σε ποιο νόμισμα να στείλω το ποσό;
Το μικτό ποσό στο δικό του νόμισμα, μαζί με τον κωδικό νομίσματος. Το Atlas κλειδώνει την ισοτιμία κατά τη λήψη, μετατρέπει σε ευρώ (λογιστικό νόμισμα) και υπολογίζει την προμήθεια με τον δικό σας συντελεστή. Όποια προμήθεια στείλετε αγνοείται.
Είναι ιδεμπότης το postback;
Ναι. Το κλειδί είναι το externalOrderId: η εκ νέου αποστολή της ίδιας κατάστασης δεν κάνει τίποτα, και η μηχανή καταστάσεων απορρίπτει τις απαγορευμένες μεταβάσεις με 409 αντί να τις εφαρμόσει σιωπηλά.
Μπορώ να ενσωματωθώ μέσω Impact, Partnerize ή Awin;
Ναι. Παρέχουμε τυπικό postback S2S που συνδέεται απευθείας με Impact, Partnerize, Awin, Voluum, RedTrack και Everflow. Μπορείτε επίσης να στέλνετε μετατροπές σε δικό σας webhook BI ή να τις εξάγετε σε CSV.
Έχετε προδιαγραφή OpenAPI;
Ναι, δημόσια και χωρίς σύνδεση. Η σελίδα αναφοράς παράγεται από αυτή την προδιαγραφή σε κάθε build, οπότε τεκμηρίωση και συμβόλαιο δεν μπορούν να αποκλίνουν.
Υποστηρίζετε MCP;
Σε ιδιωτική beta. Ο διακομιστής MCP εκθέτει την τιμολόγηση, τη σύγκριση και τη σύναψη ως τυποποιημένα εργαλεία που μπορεί να καλέσει το LLM ή ο πράκτοράς σας.
Σε τι διαθεσιμότητα και υποστήριξη μπορώ να βασιστώ;
Το API μετατροπών και οι παρακολουθούμενοι σύνδεσμοι τρέχουν σε Cloudflare Workers με αυτόματη εναλλαγή· στοχεύουμε σε 99,9 % διαθεσιμότητα. Η υποστήριξη μέσω email απαντά εντός μίας εργάσιμης ημέρας και οι ερωτήσεις ενσωμάτωσης φτάνουν στην ομάδα μηχανικών εταίρων. Η σελίδα κατάστασης είναι δημόσια.
Χρειάζεται δεύτερο κλειδί για το Coach;
Όχι. Ένα κλειδί ανοίγει όλο το API: τιμολόγηση, παρακολουθούμενους συνδέσμους και Coach. Ίδια υπογραφή, ίδιος μετρητής, ίδια όρια.
Τεχνική ή εμπορική ερώτηση; Επικοινωνήστε μαζί μας
Ας χτίσουμε
Προσθέστε ταξιδιωτική ασφάλιση στο προϊόν σας
Δημιουργήστε λογαριασμό και φτιάξτε κλειδί sandbox με ένα κλικ: σταθερά δείγματα δεδομένων, κανένας ασφαλιστής δεν καλείται, τίποτα δεν υπογράφεται. Η πρόσβαση παραγωγής είναι μια σύντομη εξέταση μόλις τρέξει η ενσωμάτωσή σας.