User Tools

Site Tools


setscorecard

/hcp/setscorecard

Edit an existing scorecard.

parameters:

auth the authorisation code you received from Intogolf BV (mandatory)
relnr the id of the golfer (mandatory)
rscnr the id of the scorecard (mandatory). This is the same id you get returned by the /hcp/newscorecard API call
epenr the id of the player within a competition. if epenr is provided, you can omit chhnr, date, time, ratnr and handicap, because any values provided for these parameters will be overruled by whatever is defined inside the competition.
chhnr the id of the registration in the handicap history.
date mandatory unless epenr is provided. format yyyymmdd. The date will not be changed if the scorecard is connected to an existing flight (flpnr provided with /hcp/newscorecard) or connected to an existing competition (epenr provided with newscorecard)
time starttime is mandatory unless epenr is provided. formatted as minutes since midnight (10:00 = 600, 12:40 = 760) The time will not be changed if the scorecard is connected to an existing flight (flpnr provided with /hcp/newscorecard) or connected to an existing competition (epenr provided with /hcp/newscorecard)
ratnr id of the measured course. mandatory unless epenr is provided. ratnr is a unique identifier for the combination of golfclub, which 9 or 18 holes loops and tee color. Only tee color can be changed with this parameter if the scorecard is connected to an existing flight (flpnr provided with /hcp/newscorecard) or connected to an existing competition (epenr provided with /hcp/newscorecard.)
markername of the marker
handicapEGA or clubhandicap of the golfer
strokes1number of strokes for hole 1
strokes2number of strokes for hole 2
strokes3number of strokes for hole 3
strokes4number of strokes for hole 4
strokes5number of strokes for hole 5
strokes6number of strokes for hole 6
strokes7number of strokes for hole 7
strokes8number of strokes for hole 8
strokes10number of strokes for hole 10
strokes11number of strokes for hole 11
strokes12number of strokes for hole 12
strokes13number of strokes for hole 13
strokes14number of strokes for hole 14
strokes15number of strokes for hole 15
strokes16number of strokes for hole 16
strokes17number of strokes for hole 17
strokes18number of strokes for hole 18

You only need to provide the parameters you wish to change, except for auth, relnr and rscnr which are mandatory. This way it is possible to create a scorecard with [newscorecard] and then provide the number of strokes hole by hole. You can of course also provide the number of strokes for hole 1 to 18 in 1 call.

example: https://backend.ikgagolfen.nl/hcp/setscorecard?auth=<your authorisation code>&645347&relnr=123456&rscnr=12345&strokes4=6

result: see /hcp/getscorecard

Possible errors:

401 Unauthorized
406 Invalid relnr
406 Date not valid
406 Time not valid
406 Invalid course
406 Scorecard locked
500 Unexpected result 00021
setscorecard.txt · Last modified: 2013/12/16 14:20 (external edit)