Οδηγίες διασύνδεσης
Οι νέες διασυνδέσεις στέλνουν κρατήσεις με server-to-server POST. Η κράτηση μπαίνει στη λίστα του συνεργάτη που ανήκουν τα API keys.
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"
}
}'
{
"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 }'