API κρατήσεων - Οδηγίες διασύνδεσης - WoW Travel Services
Διασύνδεση

Οδηγίες διασύνδεσης

Οι νέες διασυνδέσεις στέλνουν κρατήσεις με server-to-server POST. Η κράτηση μπαίνει στη λίστα του συνεργάτη που ανήκουν τα API keys.

POST https://app.wow-services.com/api/transfer/new

Πού στέλνετε την κράτηση

Οι νέες διασυνδέσεις στέλνουν κρατήσεις στο POST https://app.wow-services.com/api/transfer/new. Η κράτηση μπαίνει στη λίστα του συνεργάτη που ανήκουν τα API keys.

Τα keys βγαίνουν από Partner → Settings → API Keys. Η ίδια σελίδα έχει και την αγγλική τεκμηρίωση, στο API Documentation → Insert reservations.

Πριν την πρώτη κλήση

Κάθε request είναι server-to-server, με Content-Type: application/json και τα δύο headers:

X-Api-Public-Key: <public key> X-Api-Private-Key: <private key>

Ο συνεργάτης βγαίνει από το public key. Το wow_company_id στο body είναι προαιρετικό. Αν το στείλετε, πρέπει να είναι το δικό σας partner ID, αλλιώς η απάντηση είναι 403.

Το όριο είναι 250 requests το λεπτό.

Ελάχιστο request

Υποχρεωτικά μέσα στο parsed_data είναι μόνο πέντε πεδία: from, to, date, pickup_time, name.

Παράδειγμα
curl -X POST https://app.wow-services.com/api/transfer/new \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Api-Public-Key: $WOW_PUBLIC_KEY" \
  -H "X-Api-Private-Key: $WOW_PRIVATE_KEY" \
  -d '{
    "parsed_data": {
      "from": "Heraklion Airport (HER)",
      "to": "Paralos Lifestyle Beach",
      "date": "2026-09-08",
      "pickup_time": "12:00",
      "name": "John Doe",
      "phone_number": "+306900000000",
      "passengers": "3",
      "vehicle_category": "Minivan",
      "flight": "BA1234",
      "cost": "60.00",
      "remaining_cash": "35.00",
      "ref_number": "338802109"
    }
  }'
Επιτυχία, 201
{
  "success": true,
  "message": "Transfer created successfully",
  "reservation_id": 12345,
  "spreadsheet_view_id": 12345,
  "code": "338802109"
}

Κρατήστε το code και το reservation_id. Το code είναι το κλειδί για ενημέρωση και ακύρωση. Αν δεν στείλετε ref_number, το σύστημα φτιάχνει κωδικό με πρόθεμα TR.

Πεδία

Πεδίο Υποχρεωτικό Τι γίνεται
from to ναι Παραλαβή και παράδοση
date ναι YYYY-MM-DD. Άλλη μορφή μπορεί να αποθηκευτεί λάθος
pickup_time ναι HH:MM ή HH:MM:SS. Αν δεν διαβάζεται, μπαίνει 00:00:00
name ναι Όνομα επιβάτη
ref_number όχι Γίνεται ο κωδικός της κράτησης
phone_number όχι Με κωδικό χώρας
passengers όχι Default 1. Χρησιμοποιείται και στο ταίριασμα οχήματος
vehicle_category όχι Π.χ. Minivan. Alias: vehicle_type
flight όχι Αριθμός πτήσης. Alias: flight_number
cost όχι Σύνολο. Default 0. Γίνεται και το μετρητά, αν δεν στείλετε remaining_cash
remaining_cash όχι Όσα εισπράττει ο οδηγός επί τόπου
eurobank paypal όχι Ποσά που έχουν ήδη πληρωθεί
hotel όχι Αν το from/to είναι γενική περιοχή, αντικαθιστά την πλευρά που δεν είναι αεροδρόμιο, λιμάνι ή σταθμός
infant_seat όχι Κάθισμα 0–1. Aliases: baby_seat, baby_seat_infant
child_seat όχι Κάθισμα 1–4. Aliases: baby_seat_2, baby_seat_child, baby_seat_toddler
booster όχι Κάθισμα 4–12. Aliases: booster_seat, baby_seat_booster
comments όχι Σημειώσεις για dispatch και οδηγό
custom_fields όχι Ελεύθερο JSON object
provider_id όχι Στο top level, όχι μέσα στο parsed_data. Πρέπει να υπάρχει στους providers

Το 0 σε κάθισμα δεν γράφεται. Δεν υπάρχει πεδίο email πελάτη. Βάλτε το email στα comments ή στα custom_fields.

Χωρίς provider_id, η εταιρεία της κράτησης γράφεται Transfer API. Το status γίνεται active.

Το όχημα ταιριάζει πρώτα από τον πίνακα αντιστοίχισης του συνεργάτη, μετά από το όνομα, και τέλος από τον αριθμό επιβατών. Το κείμενο που στείλατε μένει πάντα στη στήλη του αυτοκινήτου.

Πολλές κρατήσεις μαζί

Το parsed_data μπορεί να είναι array. Κάθε στοιχείο γίνεται ξεχωριστή κράτηση. Χρησιμοποιήστε μοναδικό ref_number ανά σκέλος, π.χ. 338802109-1 και 338802109-2.

Αν όλα περάσουν, η απάντηση είναι 201 με transfers. Αν κάποια αποτύχουν αφού περάσει το validation, η απάντηση είναι 207: όσα πέτυχαν έχουν ήδη αποθηκευτεί. Ξαναστείλτε μόνο τα indexes μέσα στο failures.

Σφάλματα

Status Σημαίνει
401 Λείπουν ή είναι λάθος τα keys
403 Το wow_company_id δεν είναι ο κάτοχος του key
422 Validation. Δεν δημιουργήθηκε τίποτα
500 Απέτυχε η αποθήκευση μίας κράτησης

Το endpoint δεν είναι idempotent. Το ίδιο ref_number δύο φορές φτιάχνει δύο κρατήσεις με τον ίδιο κωδικό. Σε timeout, ελέγξτε πρώτα με GET /api/partner/reservations αν η κράτηση μπήκε, και μετά ξαναστείλτε.

Ενημέρωση και ακύρωση

Αυτά τα δύο δεν ζητούν API keys. Ο έλεγχος γίνεται με τον αρχικό συνεργάτη της κράτησης.

Ενημέρωση · Μόνο τα πεδία που στέλνετε αλλάζουν.
curl -X POST https://app.wow-services.com/api/updatebooking \
  -H "Content-Type: application/json" \
  -d '{
    "code": "338802109",
    "wow_company_id": "420",
    "parsed_data": { "pickup_time": "14:00", "cost": "75.00" }
  }'
Ακύρωση
curl -X POST https://app.wow-services.com/api/cancelbooking \
  -H "Content-Type: application/json" \
  -d '{ "code": "338802109", "partner_id": 420 }'

Χρειάζεστε βοήθεια;

Αν η διασύνδεση δεν περνάει, στείλτε μας το status code και το body της απάντησης.

Επικοινωνία