setscorecard
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
setscorecard [2013/12/11 14:54] richard created |
setscorecard [2013/12/16 14:20] (current) |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| |auth |the authorisation code you received from Intogolf BV (mandatory)| | |auth |the authorisation code you received from Intogolf BV (mandatory)| | ||
| |relnr |the id of the golfer (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 newscorecard API call| | + | |rscnr |the id of the scorecard (mandatory). This is the same id you get returned by the [[newscorecard|/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.| | |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. | | |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 providied with newscorecard) or connected to an existing competition (epenr provided with newscorecard)| | + | |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 [[newscorecard|/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 providied with 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 [[newscorecard|/hcp/newscorecard]]) or connected to an existing competition (epenr provided with [[newscorecard|/hcp/newscorecard]])| |
| - | |ratnr |id of the measured course. mandatory unless epenr is provided. ratnr is a nuque identifier for the combination of golfclub, which 9 or 18 holes loops and tee color. The course will not be changed if the scorecard is connected to an existing flight (flpnr providied with newscorecard) or connected to an existing competition (epenr provided with 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 [[newscorecard|/hcp/newscorecard]]) or connected to an existing competition (epenr provided with [[newscorecard|/hcp/newscorecard]].)| |
| + | |marker|name of the marker| | ||
| + | |handicap|EGA or clubhandicap of the golfer| | ||
| + | |strokes1|number of strokes for hole 1| | ||
| + | |strokes2|number of strokes for hole 2| | ||
| + | |strokes3|number of strokes for hole 3| | ||
| + | |strokes4|number of strokes for hole 4| | ||
| + | |strokes5|number of strokes for hole 5| | ||
| + | |strokes6|number of strokes for hole 6| | ||
| + | |strokes7|number of strokes for hole 7| | ||
| + | |strokes8|number of strokes for hole 8| | ||
| + | |strokes10|number of strokes for hole 10| | ||
| + | |strokes11|number of strokes for hole 11| | ||
| + | |strokes12|number of strokes for hole 12| | ||
| + | |strokes13|number of strokes for hole 13| | ||
| + | |strokes14|number of strokes for hole 14| | ||
| + | |strokes15|number of strokes for hole 15| | ||
| + | |strokes16|number of strokes for hole 16| | ||
| + | |strokes17|number of strokes for hole 17| | ||
| + | |strokes18|number of strokes for hole 18| | ||
| - | example: https://backend.ikgagolfen.nl/igg/newscorecard?auth=<your authorisation code>&645347&relnr=123456&epenr=12345 | ||
| - | example: https://backend.ikgagolfen.nl/igg/newscorecard?auth=<your authorisation code>&645347&relnr=123456&chhnr=12345&date=20131126&time=630&ratnr=1234 | ||
| + | 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. | ||
| - | result: | ||
| - | <code>{ | ||
| - | "newscorecard": [ | ||
| - | { | ||
| - | "rscnr": 1234 | ||
| - | }, | ||
| - | ] | ||
| - | }</code> | ||
| + | example: https://backend.ikgagolfen.nl/hcp/setscorecard?auth=<your authorisation code>&645347&relnr=123456&rscnr=12345&strokes4=6 | ||
| + | |||
| + | |||
| + | result: see [[getscorecard|/hcp/getscorecard]] | ||
| - | |rscnr |internal id of the scorecard| | ||
| Possible errors: | Possible errors: | ||
| Line 36: | Line 49: | ||
| |406| Time not valid| | |406| Time not valid| | ||
| |406| Invalid course| | |406| Invalid course| | ||
| + | |406| Scorecard locked| | ||
| |500| Unexpected result 00021| | |500| Unexpected result 00021| | ||
setscorecard.1386773690.txt.gz · Last modified: 2013/12/11 14:54 by richard
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
