This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
getflight [2013/05/23 15:24] richard |
getflight [2014/05/21 10:48] (current) |
||
---|---|---|---|
Line 10: | Line 10: | ||
|starttime |time the flightreservation is made for in minutes since midnight (600 = 10 o'clock, 720 is noon) | | |starttime |time the flightreservation is made for in minutes since midnight (600 = 10 o'clock, 720 is noon) | | ||
- | At least one of the parameters fltnr, relnr, relnrlocal, startdate, strttime is needs to be provided, otherwise the return code 449 - Retry with valid parameters is returned. | + | At least one of the parameters fltnr, relnr, relnrlocal, startdate, strttime needs to be provided, otherwise the return code 449 - Retry with valid parameters is returned. |
- | If the parameters fltnr and/or startdate are nort provided, the resultset will always be limited to startdates >= today | + | If the parameters fltnr and/or startdate are not provided, the resultset will always be limited to startdates >= today |
If the parameter fltnr is provided all other selection parameters are ignored. | If the parameter fltnr is provided all other selection parameters are ignored. | ||
Line 19: | Line 19: | ||
If the result set is longer than 1000 records, it will be truncated. | If the result set is longer than 1000 records, it will be truncated. | ||
+ | |||
+ | If a wrong authorisation code is provided, the backend will return 401,“Unauthorized” | ||
example: https://backend.intogolf.com/itg/getflight?auth=<your authorisation code>&relnr=659764&startdate=20130530 | example: https://backend.intogolf.com/itg/getflight?auth=<your authorisation code>&relnr=659764&startdate=20130530 | ||
Line 30: | Line 32: | ||
{ | { | ||
"fltnr": 3436124, | "fltnr": 3436124, | ||
- | "startdate": 735383, | + | "startdate": 20130530, |
"starttimebooked": 510, | "starttimebooked": 510, | ||
"starttimefixed": false, | "starttimefixed": false, | ||
Line 44: | Line 46: | ||
"carnr": 0, | "carnr": 0, | ||
"carname": null, | "carname": null, | ||
+ | "locked_by": 205, | ||
"players": [ | "players": [ | ||
{ | { | ||
Line 134: | Line 137: | ||
"carnr": 0, | "carnr": 0, | ||
"gfcname": "10 rittenkaart", | "gfcname": "10 rittenkaart", | ||
- | "gfcdatefrom": 735376, | + | "gfcdatefrom": 20130501, |
- | "gfcdateto": 735740, | + | "gfcdateto": 20140430, |
"totalrounds": 10, | "totalrounds": 10, | ||
"usedrounds": 0, | "usedrounds": 0, | ||
Line 147: | Line 150: | ||
}</code> | }</code> | ||
- | if a wrong authorisation code is provided, the backend will return 401,“Unauthorized” | + | Flight info: |
+ | |fltnr |internal id of this flight| | ||
+ | |startdate |date at which the golfround will be played in YYYYMMDD format| | ||
+ | |starttimebooked|teetime that was booked in minutes since midnight| | ||
+ | |starttimefixed |if true, this teetime is not allowed to shift for teesheet optimization| | ||
+ | |starttime |teetime (same as starttimebooked unless automatic teesheet optimization is enabled)| | ||
+ | |breaktime |pauze in minutes between 9th hole and 10th tee| | ||
+ | |time2 |teetime on the second course loop (10th tee)| | ||
+ | |crlnr1 |internal id of first courseloop| | ||
+ | |crlnr2 |internal id of 2nd courseloop. If 0 only 9 holes are played| | ||
+ | |nrofplayers |number of players in the flight (can be more than 4)| | ||
+ | |nomerging |if true it is not possible to add another booking to fill up the 4 places in a flight| | ||
+ | |origin |1 - phone/reception, 2 - internet| | ||
+ | |timestamp |date and time the booking was made| | ||
+ | |carnr |internal id of reason if the booking was canceled| | ||
+ | |carname |description of cancelreason| | ||
+ | |locked_by |id of the computer that holds the flight in a lock| | ||
+ | |||
+ | Players (if the parameter fltnr was provided, these subrecords may also include players that have canceled (carnr>0): | ||
+ | |flpnr|internal id of the flight player| | ||
+ | |relnr|global id of the golfer (can be 0 if the golfer is not known globally)| | ||
+ | |relnrlocal|local id of the golfer for this golfcourse (can be 0 if the golfer is not known locally)| | ||
+ | |name|name of the golfer| | ||
+ | |phone|phone number| | ||
+ | |handicap|handicap of the golfer| | ||
+ | |grfnr|internal id of the greenfee| | ||
+ | |grfname|name of the greenfee| | ||
+ | |greenfee|greenfee price| | ||
+ | |grfnrdiscount|internal id of discount| | ||
+ | |grfnamediscount|name of discount| | ||
+ | |discount|discount amount| | ||
+ | |gfcnr|internal id of greenfeecard| | ||
+ | |gfcname|name of the greenfeecard| | ||
+ | |gfcdatefrom|date the greenfeecard became valid| | ||
+ | |gfcdateto| date after which the greenfeecard is expired| | ||
+ | |totalrounds|total value of the greenfeecard| | ||
+ | |usedrounds|used up value of the greenfeecard (totalrounds - usedrounds = balance). Beware that this value will only include the current flight if the player has checked in| | ||
+ | |gfcnrdiscount|internal id of discountcard| | ||
+ | |gfcdatefromdiscount|date the discountcard became valid| | ||
+ | |gfcdatetodiscount| date after which the discountcard is expired| | ||
+ | |totalroundsdiscount|total value of the discountcard| | ||
+ | |usedroundsdiscount|used up value of the discountcard (totalrounds - usedrounds = balance). Beware that this value will only include the current flight if the player has checked in| | ||
+ | |scorecardnr|internal id of scorecard if the player has checked in (use this to test if the player has checked in and payed)| | ||
+ | |qualifyingnr|internal id of qualifying card| | ||
+ | |carnr|internal id of cancel reason if this player was canceled| | ||
+ | |||
+ | Rentals (if a rental record was assigned to a specific player, the record will appear as a subrecord to that player in the resultset. All rental records that are not assigned to a player will be treated as if they were assigned to the first player in the flight): | ||
+ | |||
+ | |rentalnr|internal id id the rental record| | ||
+ | |rentaltypenr|internal id of the type of object that was rented| | ||
+ | |rentaltype|name of the type of object that was rented| | ||
+ | |rentalitemnr|internal id of the item that was rented (if specified)| | ||
+ | |rentalitem|name if the item that was rented if specified (i.e. Buggy 3)| | ||
+ | |rentaltimefrom|time from in minutes since midnight| | ||
+ | |rentaltimeto|time to in minutes since midnight| | ||
+ | |extratimebefore|extra time the item is blocked before time from| | ||
+ | |extratimeafter|extra time the item is blocked after time to| | ||
+ | |extrainfo|extra info textfield| | ||
+ | |rentalprice|rental fee| | ||
+ | |checkedin|if true the rental item was checked in together with the player and has been paid for| | ||