User Tools

Site Tools


bookteetime

/igg/bookteetime

Book a new teetime reservation or change an existing reservation

parameters:

auth the authorisation code you received from Intogolf BV (mandatory)
crsnr the id of the course (mandatory)
date the date the golfer wishes to play (mandatory)
teetime the teetime the golfer wishes to play (mandatory)
crlnr1 the id of the first courseloop to be played (mandatory)
crlnr2 the id of the 2nd courseloop in case this is to be a booking for 18 holes
players the nr of players (min 1 max 4)
relnr the id of the golfer that is currently logged in (if omitted relnr1 is used)
relkey the hash key that was provided upon login (mandatory if relnr>0)
relnr1 the id of the 1st golfer in the flight (the owner of the booking) (mandatory)
relnr2 the id of the 2nd golfer in the flight if players>1.
relnr3 the id of the 3rd golfer in the flight if players>2.
relnr4 the id of the 4th golfer in the flight if players>3.
(instead of relnr2 - relnr4 you can also specify name2 - name4 although that is not the prefered way)
name2 name of the 2nd golfer if players>1 and relnr2=0
name3 name of the 3rd golfer if players>2 and relnr3=0
name4 name of the 4th golfer if players>3 and relnr4=0
cirnr2 id of invitation option for player 2 (relnr2 and name2 are ignored)
cirnr3 id of invitation option for player 3 (relnr3 and name3 are ignored)
cirnr4 id of invitation option for player 4 (relnr4 and name4 are ignored)
copyreltolocal if 1 the personal data of the golfer will be copied to the database of the golfcourse
buggy if 1 a buggy or handicap will be booked
fltnr id of booking to be changed (omit or set to 0 for new bookings)
lng 1 english 2 dutch (default if parameter is omitted)
test Obsolete
testonly if 1 the booking will immediately be deleted (for testing in live database)

If you want to change an existing booking the parameter fltnr needs to be provided. It is not possible to change the date, courseloops or teetime of an existing booking. IN that case you need to cancel the booking first and make a new booking immediately afterwards. Parameters you can change to an existing booking are:

players the nr of players (min 1 max 4)
relnr1 the id of the 1st golfer in the flight (the owner of the booking) (mandatory)
relnr2 the id of the 2nd golfer in the flight if players>1.
relnr3 the id of the 3rd golfer in the flight if players>2.
relnr4 the id of the 4th golfer in the flight if players>3.
name2 name of the 2nd golfer if players>1 and relnr2=0
name3 name of the 3rd golfer if players>2 and relnr3=0
name4 name of the 4th golfer if players>3 and relnr4=0
cirnr2 id of invitation option for player 2 (relnr2 and name2 are ignored)
cirnr3 id of invitation option for player 3 (relnr3 and name3 are ignored)
cirnr4 id of invitation option for player 4 (relnr4 and name4 are ignored)
buggy if 1 a buggy or handicap will be booked

the parameter relnr is used to register who made the booking or who made the cange to an existing booking. Often it will be equal to relnr1, but it doesn’t have to be. However, it is good practise not to allow anyone else change a booking, so relnr will probably always be equal to relnr1, relnr2, relnr3 or relnr4.

example: https://backend.ikgagolfen.nl/igg/bookteetime?auth=<your authorisation code>crsnr=1&date=20121001&teetime=600&crlnr1=6&crlnr2=22&players=2&relnr1=701160&name2=Henk&testonly=1

result (if succesful):

{
  "bookteetime": [
    {
      "fltnr": 3058329,
      "errormsg": "",
      "helpurl": ""
    }
  ]
}

or if the bookings fails:

{
  "bookteetime": [
    {
      "fltnr": 0,
      "errormsg": "probleem met beschikbaarheid 10:00, rood (2 spelers)",
      "helpurl": ""
    }
  ]
}

if a wrong authorisation code is provided, the backend will return “no authorisation”

bookteetime.txt · Last modified: 2013/08/16 07:08 (external edit)