This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
newscorecard [2013/11/26 14:42] richard created |
newscorecard [2014/04/15 09:26] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====/igg/newscorecard==== | + | ====/hcp/newscorecard==== |
Create a new scorecard. | Create a new scorecard. | ||
Line 9: | Line 9: | ||
|date |mandatory unless epenr is provided. format yyyymmdd| | |date |mandatory unless epenr is provided. format yyyymmdd| | ||
|time |starttime is mandatory unless epenr is provided. formatted as minutes since midnight (10:00 = 600, 12:40 = 760)| | |time |starttime is mandatory unless epenr is provided. formatted as minutes since midnight (10:00 = 600, 12:40 = 760)| | ||
- | |ratnr |id of the measured course. mandatory unless epenr is provided| | + | |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| |
+ | |handicap|EGA or clubhandicap of the golfer (mandatory)| | ||
- | example: https://backend.ikgagolfen.nl/igg/newscorecard?auth=<your authorisation code>&645347&relnr=123456&epenr=12345 | + | example: https://backend.ikgagolfen.nl/hcp/newscorecard?auth=<your authorisation code>&645347&relnr=123456&epenr=12345&handicap=23.4 |
- | example: https://backend.ikgagolfen.nl/igg/newscorecard?auth=<your authorisation code>&645347&relnr=123456&chhnr=12345&date=20131126&time=630&ratnr=1234 | + | example: https://backend.ikgagolfen.nl/hcp/newscorecard?auth=<your authorisation code>&645347&relnr=123456&chhnr=12345&date=20131126&time=630&ratnr=1234&handicap=23.4 |
- | result: | + | result: see [[getscorecard|/hcp/getscorecard]] |
- | <code>{ | + | |
- | "gethandicaphistory": [ | + | |
- | { | + | You need to retrieve the rscnr form the resultset for later use. It is needed to edit the scorecard and can be used to easily retrieve the scorecard data. |
- | "ihhnr": 0, | + | |
- | "chhnr": 0, | + | |
- | "epenr": 188417, | + | Possible errors: |
- | "playdate": "20121205", | + | |
- | "hctnr": 3, | + | |401| Unauthorized| |
- | "stableford": 3, | + | |406| Invalid relnr| |
- | "handicapold": 16.6, | + | |406| Date not valid| |
- | "handicapnew": 0.0, | + | |406| Time not valid| |
- | "holes": 18, | + | |406| Invalid course| |
- | "hcpactive": 0, | + | |500| Unexpected result 00021| |
- | "cba": 0, | + | |
- | "course": "mixed ochtend NQ", | + | |
- | "remark": "" | + | |
- | }, | + | |
- | { | + | |
- | "ihhnr": 0, | + | |
- | "chhnr": 61674, | + | |
- | "epenr": 0, | + | |
- | "playdate": "20121128", | + | |
- | "hctnr": 2, | + | |
- | "stableford": 2, | + | |
- | "handicapold": 16.9, | + | |
- | "handicapnew": 16.6, | + | |
- | "holes": 18, | + | |
- | "hcpactive": 1, | + | |
- | "cba": 0, | + | |
- | "course": "De Turfvaert - De Turfvaert 18 holes", | + | |
- | "remark": "strokeplay winst, fred blans 1e wedstrijd" | + | |
- | }, | + | |
- | { | + | |
- | "ihhnr": 0, | + | |
- | "chhnr": 0, | + | |
- | "epenr": 186203, | + | |
- | "playdate": "20121114", | + | |
- | "hctnr": 3, | + | |
- | "stableford": 3, | + | |
- | "handicapold": 17.8, | + | |
- | "handicapnew": 16.9, | + | |
- | "holes": 18, | + | |
- | "hcpactive": 0, | + | |
- | "cba": 0, | + | |
- | "course": "mixed ochtend NQ", | + | |
- | "remark": "" | + | |
- | }, | + | |
- | ] | + | |
- | }</code> | + | |
- | |ihhnr |internal id of the record in the handicap history of practise rounds| | ||
- | |chhnr |internal id of the record in the handicap history| | ||
- | |epenr |internal id of the record that represents the golfer in the competition (if applicable)| | ||
- | |playdate |date the round was played (format yyyymmdd)| | ||
- | |hctnr |type of the handicaphistory record. possible values are: 1-set initial handicap, 2-qualifying card, 3-competition result, 4-no return, 5-revoke handicap, 6-manual handicap adjustment, 7-annual handicap evaluation, 8-non qualifying card, 9-no show, 10-disqualified| | ||
- | |stableford |stableford points| | ||
- | |handicapold |handicap before this card is computed | | ||
- | |handicapnew |handicap after this card is applied| | ||
- | |holes |nr of holes played| | ||
- | |hcpactive |1 if the handicap is active, 0 if not active| | ||
- | |cba | value that was used for cba in case of a competition | | ||
- | |course |name of the course played or name of the competition played| | ||
- | |rmark |remark entered by the user | | ||
- | if a wrong authorisation code is provided, the backend will return no result | ||