Pilot Booking Interface

Support forum for VATBOOK, the flight booking system. For general vroute queries please use vroute.premium forums above.

Moderator: Michal Rok

Pilot Booking Interface

Postby Andreas Fuchs » Sat Apr 21, 2007 10:41 am

For easier access and to have a backup of all the data from here, I have copied all the parameters from euro-book.net.

IMPORTANT: if you wish to send booking-data to VATBOOK you need to become an approved external operator by requesting your personal EID (external operator ID) and your EKEY (external operator key) to prevent unkown operators sending trash-data to our database.


PILOT BOOKING INTERFACE

Add Booking Flight

Path: http://vatbook.euroutepro.com/ext_rmt_add_flight.php

Parameters - all are required:
eid - id of external operator
ekey - key of external operator
pid - VATSIM PID
pname - pilot's Full Name
fdate - flight date [yyyymmdd]
dep - departure [ICAO]
arr - arrival [ICAO]
deptime - departure time [hhmi]
arrtime - arrival time [hhmi]
callsign
actype - Aircraft ICAO code
route - points separated by " " [space character]
remarks

Example: http://vatbook.euroutepro.com/ext_rmt_a ... ctype=B734

Output - SUCCESS:
--------------- BEGIN --------------
ACTION=ADD FP
RESULT=SUCCESS
FP ID=3905
FPC NOTES=0
FPC INFO=http://vatbook.euroutepro.com/fp_info.php?fpid=3905
[FPC POINTS]
EPWA 52.165750 20.967122 0.00
DEDOL 51.387778 20.360000 51.80
JED 50.647319 20.251206 44.60
EPKK 50.077731 19.784836 38.60
---------------- END ---------------

FPC POINT line format:
POINT WGS_DLAT WGS_DLONG DISTANCE{nm}

Output - FAILED:
--------------- BEGIN --------------
ACTION=ADD FP
RESULT=FAILED
REASON ID=15
REASON MSG=Booking date and time passed.
---------------- END ---------------

Possible REASON ID, REASON MSG:
1, undefined parameter `eid`
2, undefined parameter `ekey`
3, authorization failed - invalid `eid` or `ekey`
4, undefined parameter `pid`
5, undefined parameter `pname`
6, undefined parameter `fdate`
7, invalid flight date
8, Sorry, for this flight date: "<fdate>" vDAFIF CYCLE not found.
9, undefined parameter `dep`
10, Departure airport _dep_ not found
11, undefined parameter `arr`
12, Arrival airport _arr_ not found.
13, undefined parameter `deptime`
14, DEP Time _deptime_ is invalid
15, Booking date and time passed.
16, undefined parameter `arrtime`
17, ARR Time _arrtime_ is invalid
18, undefined parameter `callsign`
19, Sorry, but the flight with the same callsign at the same time is already booked.





Delete Booked Flight

Path: http://vatbook.euroutepro.com/ext_rmt_del_flight.php

Parameters:
eid - id of external operator
ekey - key of external operator
fpid - Booked FP ID

Example:
http://vatbook.euroutepro.com/ext_rmt_d ... &fpid=3905

Output - SUCCESS:
--------------- BEGIN --------------
ACTION=DEL FP
RESULT=SUCCESS
---------------- END ---------------

Output - FAILED:
--------------- BEGIN --------------
ACTION= DEL FP
RESULT=FAILED
REASON ID=7
REASON MSG=FP Booking ID 3905 is historical.
---------------- END ---------------

ERRORS: REASON ID, REASON MSG :

1, undefined parameter `eid`
2, undefined parameter `ekey`
3, authorization failed - invalid `eid` or `ekey`
4, undefined parameter `fpid`
5, FP Booking ID _fpid_ not found
6, You are not owner of FP Booking ID _fpid_
7, FP Booking ID _fpid_ is historical






Planned Booked ATC and Flights - only for VACC

Path: http://vatbook.euroutepro.com/ext_rmt_planned.php

Parameters:
> REQUIRED
eid - id of external operator
ekey - key of external operator

>NOT REQUIRED
fir - specified FIR in VACC eg. EDFF [useful for multi-fir VACC like VACC-SAG]
t1 - date & time PERIOD FROM [yyyymmddhhmi]
t2 - date & time PERIOD TO [yyyymmddhhmi]

Example:
http://vatbook.euroutepro.com/ext_rmt_p ... ey=test123 [for external operator TEST]

Output - SUCCESS:
--------------- BEGIN --------------
ACTION=PLANNED [V1.2] Created at 2004-11-16 19:11:16 UTC
RESULT=SUCCESS
[ATC]
EPWW,20041117,EPWA_TWR,1,1900,2100,Wojciech ¦cigala
[FLIGHTS]
EPWW,20041117,LOT002,EPWA,EDDF,1500,1630,1500,1544,B737,http://vatbook.euroutepro.com/fp_info.php?fpid=3943
---------------- END ---------------

ATC line format:
FIR,DATE{yyyymmdd},postion,voice{1=yes;0=no},from_utc{hhmi},to_utc{hhmi},full_name

FLIGHT line format:
FIR,DATE{yyyymmdd},callsign,dep,arr,dep_time_utc{hhmi},arr_time_utc{hhmi},inb_time_utc{hhmi},out_time_utc{hhmi},ac_type,fpc_info_path

Output - FAILED:
--------------- BEGIN --------------
ACTION=PLANNED [V1.2] Created at 2004-11-16 19:13:58 UTC
RESULT=FAILED
REASON ID=5
REASON MSG=not found FIR's
---------------- END ---------------

ERRORS: REASON ID, REASON MSG :
1, undefined parameter `eid`
2, undefined parameter `ekey`
3, authorization failed - invalid `eid` or `ekey`
4, this is only for VACC
5, not found FIR's
6, t1 date is not valid
7, t1 time is not valid
8, t2 date is not valid
9, t2 time is not valid
10, Sorry, for this flight date: "<fdate>" vDAFIF CYCLE not found
11, Sorry, BDRY_IDENT for this FIR "<FIR>" not defined.
12, Sorry, duplicates BDRY for this FIR "<FIR>".


If you have questions about all this stuff, please post them here! :)
Cheers, Andreas
Andreas Fuchs
 
Posts: 32
Joined: Sat Jun 10, 2006 3:59 pm

Postby XavierVN » Sun Apr 22, 2007 2:25 pm

Andreas, I am confused... Since when is this a must?
Is end my vACC bookings to vatbook without a special key, and as far as I know it still works. Do I need to change something?
Currently, I am still using Romain Rivière's script.
Xavier
ACCBE1
Xavier Van Nieuwenhuyse
ACCBE1
XavierVN
 
Posts: 24
Joined: Sun Sep 25, 2005 2:26 pm
Location: Cluny, France / Heart in Belgium

Postby Andreas Fuchs » Sun Apr 22, 2007 2:55 pm

Hi Xavier,

are you talking of booking data for ATC or for pilots ?
Cheers, Andreas
Andreas Fuchs
 
Posts: 32
Joined: Sat Jun 10, 2006 3:59 pm

Postby pverras » Sat Jun 09, 2007 7:03 pm

Hi Andreas,

The interface seems the same as euro-book.net, however the eid and ekey we already have doesn't appear to work. Have the accounts been tranfered to the euroutepro ? who do i need to contact about this?

Panos
Panagiotis Verras
ACCGR10
Hellenic vACC Webmaster
pverras
 
Posts: 5
Joined: Sat Jun 10, 2006 4:04 pm
Location: Greece

Postby Andreas Fuchs » Sat Jun 09, 2007 8:54 pm

Hi Panos,

basically it should work, but of course we did not get any EID and EKEY from euro-book.net due to unresponsiveness of the webmaster there :( Could you please send an e-mail to Michal, he will issue you a new EID and EKEY. Mind that he's currently on vacation, probably returning tomorrow!?
Cheers, Andreas
Andreas Fuchs
 
Posts: 32
Joined: Sat Jun 10, 2006 3:59 pm

Postby Michal Rok » Mon Jun 11, 2007 5:36 am

I'm back. Awaiting your email with requested user ID - I will set it up and email you back your password.


Michal
User avatar
Michal Rok
Five Star Club
 
Posts: 2417
Joined: Wed Aug 31, 2005 4:23 pm
Location: Warsaw, Poland

Re: Pilot Booking Interface

Postby Knaze » Thu Aug 14, 2008 6:14 pm

Good time Michal,

i have registration, but not have EID and EKEY. Will you explain to me (and my pilots/atco), that to do, pl?
And how about EID and EKEY for vACC?

my e-mail: knaze (at) avpu.org

I very wait Your answer and help! Thank you!

Kind regards

Director of vACC Ukraine
Igor Kikot
Knaze
 
Posts: 10
Joined: Thu Aug 14, 2008 6:06 pm

Re: Pilot Booking Interface

Postby Michal Rok » Thu Aug 14, 2008 7:01 pm

I'll set up EID and EKEY for you - and send it by email.


Michal
User avatar
Michal Rok
Five Star Club
 
Posts: 2417
Joined: Wed Aug 31, 2005 4:23 pm
Location: Warsaw, Poland

Re: Pilot Booking Interface

Postby Knaze » Fri Aug 15, 2008 7:00 am

ok Michal. thanks.

but, possibly I am an idiot, it does not work for me...
What do I wrong in or did not understand?
Code: Select all
<form method="post" name="FPL" action="http://vatbook.euroutepro.com/ext_rmt_add_flight.php">
.....
<input name="eid" id="eid" type="text"></td>
.....
<input name="ekey" id="ekey" type="text"></td>
......
                  <p>                    FLIGHT PLAN<br>
........ etc.....
<input type="submit" name="Submit" value="SUBMIT Flight Plan" />
......
        </form>
Knaze
 
Posts: 10
Joined: Thu Aug 14, 2008 6:06 pm

Re: Pilot Booking Interface

Postby Michal Rok » Fri Aug 15, 2008 7:11 am

Did you really intend to let people submit bookings directly from a form? It wasn't meant to be used directly, and instead as a back-end to existing pilot booking system.

Additionally, you're using method=POST and it should be method=GET.


Michal
User avatar
Michal Rok
Five Star Club
 
Posts: 2417
Joined: Wed Aug 31, 2005 4:23 pm
Location: Warsaw, Poland

Re: Pilot Booking Interface

Postby Knaze » Fri Aug 15, 2008 9:39 am

so... RESULT=SUCCESS
and where i can see my booking (my FPL) ? I thought can see it in vroute, but it did not happen(((
Help me, pl!

Kind regards
Igor Kikot
Knaze
 
Posts: 10
Joined: Thu Aug 14, 2008 6:06 pm

Re: Pilot Booking Interface

Postby Michal Rok » Sat Aug 16, 2008 9:09 am

Wait 20 minutes and check in vroute.


Michal
User avatar
Michal Rok
Five Star Club
 
Posts: 2417
Joined: Wed Aug 31, 2005 4:23 pm
Location: Warsaw, Poland

Re: Pilot Booking Interface

Postby Knaze » Thu Oct 09, 2008 3:44 pm

Michal,
you deleted my eid &ekey (for VACC UKRAINE)?
I tried sending my FPL to VATBOOK, but
RESULT=FAILED
REASON ID=1
Knaze
 
Posts: 10
Joined: Thu Aug 14, 2008 6:06 pm

Re: Pilot Booking Interface

Postby Michal Rok » Thu Oct 09, 2008 4:11 pm

No, i did not delete your key. Error 1 means you did not supply an EID (parameter name is actually lowercase).


Michal
User avatar
Michal Rok
Five Star Club
 
Posts: 2417
Joined: Wed Aug 31, 2005 4:23 pm
Location: Warsaw, Poland

Re: Pilot Booking Interface

Postby bendobson » Wed May 27, 2009 2:29 pm

Michal

Fantastic and easy way to allow people to do this :-)

We have applied for the EPI/KEY and have the details already, altho i am still getting an access error, is it a manual process? 24 Hours wait etc?

The application was for Fly UK VA :)

Thanks again

Ben
bendobson
 
Posts: 4
Joined: Wed May 27, 2009 2:26 pm

Next

Return to VATBOOK

Who is online

Users browsing this forum: No registered users and 1 guest

cron